Skip to content
Get Started

API Reference

Libraries

npm install sendblue
pip install sendblue

API Overview

Messages

Operations for sending and managing messages

Get messages
GET/api/v2/messages
Get a specific message
GET/api/v2/messages/{message_id}
Send a message
POST/api/send-message
Get message status
GET/api/status

Groups

Operations for group messaging (beta)

Send a group message
POST/api/send-group-message
Modify a group
POST/api/modify-group

Media Objects

Operations for uploading and managing media files

Upload a media object
POST/api/upload-media-object

Lookups

Operations for looking up service availability for phone numbers

Lookup a phone number
GET/api/evaluate-service

Typing Indicators

Operations for sending and managing messages

Send a typing indicator
POST/api/send-typing-indicator

Contacts

Operations for managing contacts

Get contacts
GET/api/v2/contacts
Create a contact
POST/api/v2/contacts
Get contact count
GET/api/v2/contacts/count
Verify a contact
POST/api/v2/contacts/verify
Get a contact
GET/api/v2/contacts/{phone_number}
Update a contact
PUT/api/v2/contacts/{phone_number}
Delete a contact
DELETE/api/v2/contacts/{phone_number}
Opt out a contact
POST/api/v2/contacts/opt-out

ContactsBulk

Operations for managing contacts

Delete multiple contacts
DELETE/api/v2/contacts
Create multiple contacts
POST/api/v2/contacts/bulk

Webhooks

Operations for managing webhook subscriptions

Get webhooks
GET/api/account/webhooks
Add webhooks
POST/api/account/webhooks
Replace webhooks
PUT/api/account/webhooks
Delete webhooks
DELETE/api/account/webhooks

Operations for sending and managing messages

Send a carousel message
POST/api/send-carousel

V2

V2Totp

Store and retrieve TOTP codes for agent 2FA (authenticator app replacement)

Get current TOTP code
GET/api/v2/totp/code/{secret_id}

V2TotpSecrets

Store and retrieve TOTP codes for agent 2FA (authenticator app replacement)

Register a TOTP secret
POST/api/v2/totp/secrets
List TOTP secrets
GET/api/v2/totp/secrets
Delete a TOTP secret
DELETE/api/v2/totp/secrets/{secret_id}