1. webhooks
Sudonum API
  • Sudonum
    • v2
      • audiofiles
        • Get a list of your uploaded audio files (MP3)
        • Upload an audio file
        • Delete an uploaded MP3 audio file
      • logs
        • Get your billable number logs
        • Get your raw number logs
        • Get your voice-call logs
      • number
        • search
          • Search for Sudonum
        • bulk
          • Update Sudonums in bulk
          • Create Sudonums in bulk
          • Partial update Sudonums in bulk
        • {number}
          • Return the details for a Sudonum
          • Update a Sudonum
          • Delete a Sudonum
          • Partial update a Sudonum
        • Return all active Sudonum numbers
        • Buy a number
      • send-sms
        • Send an SMS
        • Send multiple SMSes.
      • status
        • Get the current status of the SMS Network
        • Get the current status of the Voice Network
      • webhooks
        • {name}
          • Return the details for a webhook
          • Update a webhook
          • Delete a webhook
          • Partially update a webhook
        • Get a list of your webhooks
        • Create a webhook
      • Whatsapp
        • accounts
          • WhatsApp Accounts
          • Single WhatsApp Account
        • chat-intro-logs
          • {chat intro log uuid}/status-logs
            • All status change logs for a Chat Intro Log
            • Status change log for a Chat Intro Log
          • All Chat Intro Logs
          • Single Chat Intro Log
        • chat-intros
          • {uuid}
            • Single Chat Intro
            • Update Chat Intro
            • Delete Chat Intro
            • Partially update Chat Intro
            • Partially update Chat Intro (application/json)
          • reply components
            • Interactive Flow Reply
            • Text Reply (Default)
            • Image Reply
            • Interactive Reply CTA
            • Interactive List Reply
            • Interactive Quick Reply
          • alternative reply components
            • Text Reply
            • Image Reply
            • Interactive Quick Reply
          • aparty connect
            • Interactive CTA Reply
            • Aparty Template
            • Text Reply
          • aparty components
            • Aparty notify Flow template
            • Aparty Template Components
            • Aparty Template Components + Aparty connect
          • Create a chat intro.
          • All Chat Intros
          • Create Chat Intro
          • Chat Intro Logs for a Chat Intro
        • message-templates
          • All WhatsApp Message Templates
          • WhatsApp Message Template
        • messages
          • {uuid}
            • Single WhatsApp Message
          • interactive messages
            • Interactive Flow Message - flow_id
            • Interactive Flow Message - flow_name
            • Send Interactive List Message
            • Send Interactive Quick Reply Message
            • Send Interactive Quick Reply Message + Media Header
            • Send Interactive Call-To-Action Message
            • Send Interactive Location Request Message
          • templates messages
            • Send Flow Template (custom token)
            • Send Flow Template (no params)
            • Send Message
            • Send Template (no body)
            • Send Template (body + url button)
            • Send Template (header IMAGE + body)
            • Send Template (header VIDEO + body)
            • Send Template (header TEXT + body)
            • Send Template (header LOCATION + body + button)
            • Send Template (Quick Reply with payload )
            • Send LTO Coupon Template (no expiry date)
            • Send LTO Coupon (WITH expiry date)
            • Send Carousel Message Template
            • Send OTP Template
            • Send Coupon Template
          • All Messages
          • All Messages from Campaign Log
          • Send Contact
          • Send Text Message
          • Send Media Message
          • Send Location Message
          • Send Reaction Message
        • webhooks
          • {uuid}
            • Single WhatsApp Webhook
            • Update a Webhook
            • Delete a Webhook
            • Partially update Webhook
          • All Webhooks
            GET
          • Create Webhook
            POST
        • template media
          • Upload Whatsapp Media
          • All Whatsapp Media
        • Flows
          • {uuid}
            • Retrieve a single flow.
            • Update a flow's name, status or category.
            • Not supported.
            • Fetch Meta's preview URL for a flow.
          • List the flows on your organisation's WABAs.
          • Not supported.
        • Leads
          • Submit WhatsApp number.
          • List the leads submitted against a WhatsApp number.
        • Start a chat intro
          POST
      • Campaigns
        • Campaigns
          • :uuid
            • Single Campaign
            • Replace Campaign
            • Update Campaign
            • Delete Campaign
            • Sample CSV for Campaign
            • Upload Contacts to Campaign
          • List of Campaigns
          • Create Campaign
        • Campaign Logs
          • :uuid
            • Single Campaign Log
            • Replace Campaign Log
            • Update Campaign Log
            • Delete Campaign Log
            • Opted-out Contacts
          • List of Campaign Logs
          • Create Campaign Log
          • Export Campaign Logs
        • Contacts
          • :uuid
            • Single Contact
            • Replace Contact
            • Update Contact
            • Delete Contact
          • List of Contacts
          • Create Contact
          • Download Contact CSV Sample File
          • Upload Contact CSV
          • Download Contact CSV sample file
        • Lists
          • :uuid
            • Single Campaign List
            • Replace Campaign List
            • Update Campaign List
            • Delete Campaign List
            • List Contacts under Campaign List
            • Export Contacts under Campaign List
          • List of Campaign Lists
          • Create Campaign List
        • Opt-outs
          • :uuid
            • Single Opt-out
            • Replace Opt-out
            • Update Opt-out
            • Single Opt-out/Opt-in Event
          • List of Opt-outs
          • Create Opt-out
          • List of Opt-out/Opt-in Events
      • Sumi Insights Config
        • /{uuid}
          • Edit Sumi Config
          • Get Sumi Config
        • Get Sumi Configs
        • Create Sumi Config
      • Sumi Agent Config
        • {uuid}
          • Config
        • All Configs
      • RoutingConfigs
        • List RoutingConfigs
        • Create a RoutingConfig
        • Retrieve a RoutingConfig
        • Replace a RoutingConfig
        • Update a RoutingConfig
        • Delete a RoutingConfig
      • Get an authentication token
        POST
      • Number prefixes available on your account
        GET
      • Call detail records
        GET
      • Number capabilities
        GET
      • Voice feature list
        GET
      • Number insights
        GET
      • SMS records
        GET
      • Start a call
        POST
      • Webhook types
        GET
    • v3
      • sumi
        • jobs
          • {uuid}
            • Retrieve a job
          • List Jobs
          • Submit a job
    • Schemas
      • JobSubmit
      • FlowStatus
      • MessagePage
      • Enquirer
      • ChatIntroCreate
      • Destination
      • BlankEnum
      • CampaignCategoryEnum
      • JobCreated
      • FlowCategory
      • Listing
      • ReplyAlt
      • TimeOfDay
      • CreateOptOutContactLogRequest
      • CreateCampaign
      • Message
      • PatchedListOptOutListRequest
      • OptOutEvent
      • ListOptOutListRequest
      • CreateCampaignRequest
      • PatchedUpdateCampaignRequest
      • UpdateCampaign
      • UpdateCampaignRequest
      • ListCampaign
      • ListOptOutList
      • ChatIntro
      • RouteConditions
      • Flow
      • CampaignErrorResponse
      • JobList
      • LeadSubmit
      • CampaignListContactUploadRequest
      • FlowList
      • MessageType
      • LeadRecord
      • RouteFallback
      • JobStatus
      • LeadPage
      • CampaignLog
      • MessageDirection
      • DetailBody
      • Route
      • FlowUpdate
      • JobDetail
      • TranscriptSegment
      • FlowPreview
      • MessageStatus
      • RoutingConfigWrite
      • CampaignStatusEnum
      • SumiInsights
      • PreviewError
      • RoutingConfigPatch
      • CampaignUploadResponse
      • ErrorsBody
      • MomentMatches
      • Detail
      • RoutingConfig
      • ChannelTypeEnum
      • Error
      • ContactUploadRequest
      • ValidationError
      • ReportCard
      • PaginatedRoutingConfigList
      • ContactUploadResponse
      • JobCallback
      • ValidationErrorBody
      • ResourcesExistBody
      • DetailBody
      • CreateCampaignList
      • CreateCampaignListRequest
      • CreateContact
      • CreateContactRequest
      • ValidationErrorBody
      • CreateOptOutContactLog
      • ExportJobResponse
      • ListCampaignList
      • ListCampaignLog
      • ListCampaignLogRequest
      • ListContactList
      • ListContacts
      • ListContactsRequest
      • NullEnum
      • OptOutCategoryEnum
      • OriginEnum
      • PaginatedListCampaignList
      • PaginatedListCampaignListList
      • PaginatedListCampaignLogList
      • PaginatedListContactsList
      • PaginatedListOptOutListList
      • PaginatedListContactListList
      • PaginatedOptOutEventList
      • PatchedListCampaignLogRequest
      • PatchedListContactsRequest
      • PatchedUpdateCampaignListRequest
      • UpdateCampaignList
      • UpdateCampaignListRequest
  1. webhooks

Create Webhook

POST
https://api.sudonum.com.com/v2/whatsapp/webhooks/
This allows you to receive updates on all the activity happening on
your WhatsApp number.

subscribed_statuses#

Available status to subscribe to on MESSAGE
['QUEUED', 'RECEIVED', 'SENT', 'DELIVERED', 'READ', 'FAILED', 'DELETED', 'BLACKLISTED_COUNTRY', 'BLACKLISTED_NUMBER', 'BLACKLISTED_KEYWORD']
Available statuses to subscribe to on CHATINTROLOG
['READY', 'APARTY_CHAT_LINK_CLICKED', 'APARTY_MESSAGE_ARRIVED', 'APARTY_MESSAGE_RECEIVED', 'BPARTY_NOTIFIED', 'BPARTY_CONFIRMED', 'APARTY_BLOCKED', 'APARTY_NOTIFICATION', 'APARTY_QUALIFYING', 'BPARTY_CONFIRMED_CSAT']

Request

Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.sudonum.com.com/v2/whatsapp/webhooks/' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'url=occaecat' \
--data-urlencode 'whatsapp_number=commodo eiusmod ut sunt labore' \
--data-urlencode 'name=' \
--data-urlencode 'is_active=true' \
--data-urlencode 'webhook_type=MESSAGE|CHATINTROLOG|ALL' \
--data-urlencode 'subscribed_statuses=[]'

Responses

🟢201
application/json
Bodyapplication/json

Example
{
    "uuid": "e3d95dc7-2ea6-44da-8d73-1917cbb5e6dc",
    "name": "all webhook",
    "whatsapp_number": "27....",
    "url": "https://destination.of.webhook",
    "is_active": true,
    "webhook_type": "ALL",
    "subscribed_statuses": [],
    "hmac_secret": "pCnhvHYX9iLmygEO4n0Im5I2WFrhcuF6",
    "created": "2024-04-24T07:14:23.893410Z",
    "modified": "2024-04-24T07:14:23.893803Z"
}
Modified at 2026-08-31 07:42:46
Previous
All Webhooks
Next
Upload Whatsapp Media
Built with