Your API key
Your Sendwo API key is available after registration. Login to your Sendwo dashboard, open the API or Developer section, and generate your API key before making requests.
How authentication works
Sendwo API requests use your dashboard-generated API token. Add the token as apiToken in your GET query string or POST body, depending on the endpoint.
Use API token
Pass your API key as apiToken with each request.
Connect systems
Use API calls from your CRM, website, app, or backend workflow.
Protect access
Never expose API keys in public frontend code or shared documents.
API base endpoint
Use the Sendwo dashboard API base URL for your API calls. If your account shows a different endpoint inside the dashboard, use the dashboard-provided endpoint.
https://login.sendwo.com/api/v1User API
Use User API endpoints to read account information, package details, module access, and usage logs connected with your Sendwo account.
User API: My Information
Fetch basic information about the current Sendwo account connected with the API token.
| Name | Description | Type | Required |
|---|---|---|---|
apiToken |
Your dashboard-generated API key. | String | Required |
https://login.sendwo.com/api/v1/user/myInfo?apiToken=API-KEYcurl -X POST \
'https://login.sendwo.com/api/v1/user/myInfo' \
-d 'apiToken=API-KEY'{
"status": "1",
"message": {
"user_id": 114,
"user_type": "Member",
"name": "Sendwo User",
"email": "member@example.com",
"package_name": "Premium",
"status": "1",
"whatsapp_bots_details": [
{
"display_phone_number": "+91 98765 XXXXX",
"phone_number_id": "PHONE_NUMBER_ID",
"whatsapp_business_account_id": "WABA_ID",
"whatsapp_business_name": "Sendwo"
}
]
}
}User API: Usage Log
Check module-wise usage limits and current consumption for the connected Sendwo account.
| Name | Description | Type | Required |
|---|---|---|---|
apiToken |
Your Sendwo API key. | String | Required |
curl -X POST \
'https://login.sendwo.com/api/v1/user/usage/log' \
-d 'apiToken=API-KEY'{
"status": "1",
"message": {
"modules": [
{
"module_name": "Message Credit",
"limit": "unlimited",
"used": 0
},
{
"module_name": "Subscribers",
"limit": 5000,
"used": 1250
}
],
"package_name": "Premium",
"total_modules": 20
}
}User API: Package List
Fetch the list of available Sendwo packages that are visible for the account.
https://login.sendwo.com/api/v1/user/package/list?apiToken=API-KEY{
"status": "1",
"message": [
{
"id": 1,
"package_name": "Free",
"package_type": "subscription",
"validity": 30
},
{
"id": 2,
"package_name": "Growth",
"package_type": "subscription",
"validity": 30
}
]
}User API: Module List
View modules enabled in your Sendwo account, such as broadcast, live chat, AI chatbot, flows, catalog, and API developer access.
curl -X POST \
'https://login.sendwo.com/api/v1/user/module/list' \
-d 'apiToken=API-KEY'WhatsApp API
Use WhatsApp API endpoints to connect accounts, send messages, upload media, fetch conversations, track delivery status, and trigger automation flows.
WhatsApp API: Connect Account
Fetch connected WhatsApp Business accounts and phone number IDs available inside the Sendwo dashboard.
https://login.sendwo.com/api/v1/whatsapp/connect/account/list?apiToken=API-KEY{
"status": "1",
"message": [
{
"id": 10,
"display_phone_number": "+91 98765 XXXXX",
"phone_number_id": "PHONE_NUMBER_ID",
"whatsapp_business_account_id": "WABA_ID",
"verified_name": "Your Brand"
}
]
}WhatsApp API: Send Text Message
Send a WhatsApp text message from a connected Sendwo WhatsApp Business API number.
| Name | Description | Type | Required |
|---|---|---|---|
apiToken |
Your dashboard-generated API key. | String | Required |
phoneNumberId |
Connected WhatsApp phone number ID. | String | Required |
to |
Recipient phone number with country code. | String | Required |
message |
Message body to send. | String | Required |
curl -X POST \
'https://login.sendwo.com/api/v1/whatsapp/send-text-message' \
-d 'apiToken=API-KEY' \
-d 'phoneNumberId=PHONE-NUMBER-ID' \
-d 'to=919876543210' \
-d 'message=Hello from Sendwo API'{
"status": "1",
"message": "Message sent successfully.",
"data": {
"message_id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIA"
}
}WhatsApp API: Send Interactive Buttons
Send an interactive WhatsApp message with quick reply buttons for lead qualification, support routing, booking, and campaign response collection.
curl -X POST \
'https://login.sendwo.com/api/v1/whatsapp/send-interactive-buttons' \
-d 'apiToken=API-KEY' \
-d 'phoneNumberId=PHONE-NUMBER-ID' \
-d 'to=919876543210' \
-d 'message=Choose an option' \
-d 'buttons[0][id]=book_demo' \
-d 'buttons[0][title]=Book Call' \
-d 'buttons[1][id]=pricing' \
-d 'buttons[1][title]=View Pricing'WhatsApp API: Send Media
Send images, documents, videos, or audio files through WhatsApp using Sendwo API.
| Name | Description | Type | Required |
|---|---|---|---|
apiToken |
Your Sendwo API key. | String | Required |
mediaType |
image, video, audio, or document. | String | Required |
mediaUrl |
Public file URL or uploaded media URL. | String | Required |
caption |
Optional caption for supported media types. | String | Optional |
curl -X POST \
'https://login.sendwo.com/api/v1/whatsapp/send-media' \
-d 'apiToken=API-KEY' \
-d 'phoneNumberId=PHONE-NUMBER-ID' \
-d 'to=919876543210' \
-d 'mediaType=image' \
-d 'mediaUrl=https://example.com/product-image.jpg' \
-d 'caption=Here is your product image'WhatsApp API: Get Conversation
Fetch recent WhatsApp conversation data for a subscriber or phone number.
https://login.sendwo.com/api/v1/whatsapp/conversation?apiToken=API-KEY&subscriberId=SUBSCRIBER-IDWhatsApp API: Message Delivery Status
Track message delivery status for WhatsApp messages sent through Sendwo.
https://login.sendwo.com/api/v1/whatsapp/message/delivery-status?apiToken=API-KEY&messageId=MESSAGE-IDWhatsApp API: Trigger Bot Flow
Trigger a saved Sendwo bot flow for a selected subscriber or recipient number.
curl -X POST \
'https://login.sendwo.com/api/v1/whatsapp/trigger-bot-flow' \
-d 'apiToken=API-KEY' \
-d 'phoneNumberId=PHONE-NUMBER-ID' \
-d 'to=919876543210' \
-d 'flowId=FLOW-ID'Subscriber API
Use Subscriber API endpoints to create, update, segment, label, and manage WhatsApp subscribers inside Sendwo.
Subscriber API: Subscribers List
Fetch subscriber records from your Sendwo account.
https://login.sendwo.com/api/v1/subscriber/list?apiToken=API-KEY&page=1{
"status": "1",
"message": [
{
"subscriber_id": 501,
"first_name": "Amit",
"last_name": "Sharma",
"phone_number": "919876543210",
"labels": ["Lead", "Ecommerce"]
}
]
}Subscriber API: Create Subscriber
Create a new subscriber inside Sendwo from your CRM, website form, ad funnel, ecommerce checkout, or lead capture system.
| Name | Description | Type | Required |
|---|---|---|---|
apiToken |
Your Sendwo API key. | String | Required |
phoneNumber |
Subscriber phone number with country code. | String | Required |
firstName |
Subscriber first name. | String | Optional |
lastName |
Subscriber last name. | String | Optional |
curl -X POST \
'https://login.sendwo.com/api/v1/subscriber/create' \
-d 'apiToken=API-KEY' \
-d 'phoneNumber=919876543210' \
-d 'firstName=Amit' \
-d 'lastName=Sharma'Subscriber API: Update Subscriber
Update subscriber details such as name, phone, custom field values, or segmentation data.
curl -X POST \
'https://login.sendwo.com/api/v1/subscriber/update' \
-d 'apiToken=API-KEY' \
-d 'subscriberId=SUBSCRIBER-ID' \
-d 'firstName=Updated Name'Subscriber API: Assign Labels
Assign one or more labels to subscribers for segmentation, retargeting, campaign filtering, or automation triggers.
curl -X POST \
'https://login.sendwo.com/api/v1/subscriber/assign-labels' \
-d 'apiToken=API-KEY' \
-d 'subscriberId=SUBSCRIBER-ID' \
-d 'labelIds=12,18,22'Subscriber API: Add Notes
Add internal notes to subscriber profiles so your sales, support, or marketing team can track context.
curl -X POST \
'https://login.sendwo.com/api/v1/subscriber/add-note' \
-d 'apiToken=API-KEY' \
-d 'subscriberId=SUBSCRIBER-ID' \
-d 'note=Customer asked for pricing details.'Label API
Use Label API endpoints to create and fetch labels for subscriber segmentation inside Sendwo.
Label API: Label List
Fetch labels created inside your Sendwo account.
https://login.sendwo.com/api/v1/label/list?apiToken=API-KEYLabel API: Create Label
Create a new label for organizing subscribers and campaigns.
curl -X POST \
'https://login.sendwo.com/api/v1/label/create' \
-d 'apiToken=API-KEY' \
-d 'labelName=High Intent Leads'Catalog API
Use Catalog API endpoints to fetch catalog details, sync catalog data, view catalog orders, and update order status where available.
Catalog API: Catalog List
Fetch connected WhatsApp catalog details from Sendwo.
https://login.sendwo.com/api/v1/catalog/list?apiToken=API-KEYCatalog API: Sync Catalog
Sync the connected catalog data with your Sendwo dashboard.
curl -X POST \
'https://login.sendwo.com/api/v1/catalog/sync' \
-d 'apiToken=API-KEY' \
-d 'catalogId=CATALOG-ID'Catalog API: Catalog Order List
Fetch WhatsApp catalog orders captured through Sendwo.
https://login.sendwo.com/api/v1/catalog/order/list?apiToken=API-KEYWebhook Workflow API
Use webhook workflows to receive or process WhatsApp events, automate business actions, and connect Sendwo with external systems.
Webhook API: Workflow List
Fetch webhook workflows created in your Sendwo dashboard.
https://login.sendwo.com/api/v1/webhook/workflow/list?apiToken=API-KEYWebhook API: Create Workflow
Create a webhook workflow for automation, data forwarding, or external app communication.
curl -X POST \
'https://login.sendwo.com/api/v1/webhook/workflow/create' \
-d 'apiToken=API-KEY' \
-d 'workflowName=New Lead Webhook' \
-d 'targetUrl=https://example.com/webhook'Need help with Sendwo API?
If you are connecting Sendwo with your CRM, ecommerce store, website forms, custom backend, or automation stack, our team can help you understand the best API flow for your use case.
WhatsApp-first help
Paid Sendwo users can get dedicated support for setup, training, and troubleshooting.
Integration guidance
Connect API workflows with Shopify, WooCommerce, Zapier, Pabbly, Make, n8n, and custom apps.
Use-case mapping
Plan the right API flow for lead capture, broadcasts, order updates, abandoned cart, and support automation.