Skip to main content
POST
/
messages
/
individual
/
{accountId}
/
send
Send Message
curl --request POST \
  --url https://api.a1base.com/v1/messages/individual/{accountId}/send \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --data '
{
  "content": "<string>",
  "from": "<string>",
  "to": "<string>",
  "service": "whatsapp",
  "attachment_uri": "<string>"
}
'
{
  "to": "<string>",
  "from": "<string>",
  "body": "<string>",
  "status": "queued",
  "date_created": "2023-11-07T05:31:56Z"
}

​
Sending Messages:

  • Group Chats: The agent’s phone number must first be added to the group chat before messages can be sent.
  • Individual Chats: A user must initiate the conversation with the agent’s phone number before the agent can send messages.
NPM Package https://www.npmjs.com/package/a1base-api

​
Sending Text Messages

POST /individual/{accountId}/send
Headers:
  x-api-key: your_api_key
  x-api-secret: your_api_secret
  Content-Type: application/json

Body:
{
  "from": "+14155552671",
  "to": "+14155551234",
  "service": "whatsapp",
  "message": "Hello, this is a test message!"
}

​
Sending Media Messages

​
Individual Media Message

To send an image to an individual: 
POST /individual/{accountId}/send
Headers:
  x-api-key: your_api_key
  x-api-secret: your_api_secret
  Content-Type: application/json

Body:
{
  "from": "+14155552671",
  "to": "+14155551234",
  "service": "whatsapp",
  "message_type": "media",
  "media_url": "https://example.com/images/sample.jpg",
  "media_type": "image",
  "caption": "Check out this image!"
}

​
Using the Universal Endpoint

You can also use the newer universal endpoint for both text and media messages: 
POST /send/{accountId}
Headers:
  x-api-key: your_api_key
  x-api-secret: your_api_secret
  Content-Type: application/json

Body:
{
  "from": "+14155552671",
  "to": "+14155551234",
  "service": "whatsapp",
  "type": "individual",
  "content": {
    "type": "media",
    "media_url": "https://example.com/videos/demo.mp4",
    "media_type": "video",
    "caption": "Product demo video"
  }
}

​
Supported Media Types

The API supports these media types:
  • image: For images (JPG, PNG, etc.)
  • video: For video files
  • audio: For audio files
  • document: For documents (PDF, DOC, etc.)

​
Important Notes

  • The media_url must be a publicly accessible URL where the media file can be downloaded.
  • The caption field is optional. You can send media without a caption if desired.
  • Make sure your media files are in formats supported by WhatsApp.
  • There are size limits for different media types:
    • Images: Generally up to 5MB
    • Videos: Generally up to 16MB
    • Audio: Generally up to 16MB
    • Documents: Generally up to 100MB
  • The from number must be a WhatsApp-enabled number that your account has permission to use.
  • The to number for individual messages must be a valid WhatsApp number.

Authorizations

​
X-API-Key
string
header
required
​
X-API-Secret
string
header
required

Headers

​
X-API-Key
string
required
​
X-API-Secret
string
required

Path Parameters

​
accountId
string
required

Account ID

Body

application/json
​
content
string
required

Message body text

​
from
string
required

Sender phone number

​
to
string
required

Recipient phone number

​
service
enum<string>
required

Messaging service to use

Available options:
whatsapp,
telegram
​
attachment_uri
string

Optional file/media attachment

Response

Message sent successfully

​
to
string
​
from
string
​
body
string
​
status
enum<string>
Available options:
queued,
sent
​
date_created
string<date-time>