Jump to Content
Enterprise Communications API
Get Started
Reference
Home
Get Started
Reference
Enterprise Communications API
Get Started
Reference
Select Product
Portal
Log In
Reference
Select Product
Portal
Log In
Reference
Calling the One API
All
Pages
Start typing to search…
JUMP TO
The "One" API
The One API Overview
Calling the One API
Addressing your messages
Message sending across channels
Custom messages
Multi part messages
Templates
Channel selection
Additional options
Message send response
Inbound messages and receipts
Channels
SMS
Email
Push
WhatsApp
Facebook
Twitter DM
App Messaging
Custom Channels
Branch
Webhooks
Webhooks
One API - Message Events
One API - Profile Events
Facebook Events
App Messaging - Conversation Events
App Messaging - Message Events
App Messaging - Session Events
Chat - Events
Chat - Message Events
Chat - Presence Events
App Messaging
App Messaging Overview
Android
Installing the SDK
Initialise
Start session
Client APIs
Listen to events
Push messages
Messaging service
Profile service
iOS
Installing the SDK
Initialise
Start session
Push messages
Listen to events
Client APIs
Profile services
Messaging services
JavaScript
Install the SDK
Initialise
Create conversation
Send message
Query conversations
Query conversation messages
Query events
Websocket events
Message status updates
Profile API
Typescript
Cordova
Chat
Chat API
Web Chat Widget
Android Chat
Installing the SDK
Initialise
Chat Store
Start session
Client APIs
Listen to events
Messaging service
Profile service
JavaScript Chat
Install the Chat SDK
Initialise the Chat SDK
Chat Conversation Store
Chat Client APIs
Chat Client Events
Chat Client Messaging Service
iOS Chat
Installing the SDK
Initialise
Chat Store
Start session
Profile services
Messaging services
Listen to events
Client APIs
SMS
SMS API Overview
SMS Reference
SMS Message Encoding
SMS Message Segmentation
SMS Message Statuses
Verify
Verify API
Create and Send Code
Validate Code
Verify Error Codes
Message "One" API
/apispaces/{apiSpaceId}/messages/{messageId}/statuses/{status}
Posts a status for a message
post
/apispaces/{apiSpaceId}/messages/{messageId}
Retrieves the current state of a specific message.
get
Deletes a Message
del
Patches a Message
patch
/apispaces/{apiSpaceId}/messages
Send a new message
post
/apispaces/{apiSpaceId}/messages/batch
Send a batch of new messages
post
/apispaces/{apiSpaceId}/messages/inbounds
Posts an inbound message
post
/apispaces/{apiSpaceId}/messages/inbounds/{inboundMessageId}/statuses/{status}
Posts a status for an inbound
post
Message History API
/apispaces/{apiSpaceId}/profiles/{profileId}/messages
Retrieves message history for the specified profile. Messages retrieved from the date spacified (default now), in descending time order.
get
Content API
/apispaces/{apiSpaceId}/content/{fileId}
Retrieve a file
get
Profile API
/apispaces/{apiSpaceId}/profiles/export
Exports the result of a profile query in a formatted file for download
post
/apispaces/{apiSpaceId}/profiles/bulk
Creates or updates the supplied profiles with the supplied data
patch
Deletes the requested profiles
del
/apispaces/{apiSpaceId}/profiles/{id}
Retrieves a Profile
get
Updates or undeletes a Profile
put
Patches a Profile
patch
Deletes a Profile
del
/apispaces/{apiSpaceId}/profiles/{id}/optin
Set profile opt in for specified channels
put
Set profile opt in for specified channels
del
/apispaces/{apiSpaceId}/profiles/{id}/rels/primary/{linkedId}
Creates a relationship where the linked profile is the primary and this profile is a child
put
Deletes the profile's relationship to a primary profile
del
/apispaces/{apiSpaceId}/profiles/{id}/rels/link/{linkedId}
Creates a relationship where this profile is the primary and the linked profile is a child
put
Deletes the primary profile's relationship to a linked Profile
del
/apispaces/{apiSpaceId}/profiles
Query profiles
get
Creates a new Profile
post
/apispaces/{apiSpaceId}/profiles/import
Start the import process
post
/apispaces/{apiSpaceId}/profiles/optin
Gets default profiles opt in/out options for each channel in channel service
get
Set default profiles opt in/out options for each channel in channel service
put
/apispaces/{apiSpaceId}/profiles/import/{id}/duplicates
Get information about duplicated profiles
get
/apispaces/{apiSpaceId}/profiles/import/{id}/start
Start the import process
put
/apispaces/{apiSpaceId}/audiences/{id}
Retrieves an audience
get
Updates an audience
put
Deletes an audience
del
/apispaces/{apiSpaceId}/audiences
Query audience
get
Creates a new audience
post
Conversation API
/apispaces/{apiSpaceId}/conversations/{conversationId}
Retrieves a conversation
get
Updates a conversation
put
Deletes a conversation
del
/apispaces/{apiSpaceId}/conversations
Creates a new conversation
post
Retrieves a list of conversations
get
/apispaces/{apiSpaceId}/conversations/{conversationId}/typing
Indicates that the caller is typing in this conversation
post
Indicates that the caller has stopped typing in this conversation
del
/apispaces/{apiSpaceId}/conversations/{conversationId}/participants
Retrieves the conversation participants
get
Adds a list of participants to a conversation
post
Deletes a list of participants from a conversation
del
Conversation Message API
/apispaces/{apiSpaceId}/conversations/{conversationId}/events
Retrieves a conversation's events
get
/apispaces/{apiSpaceId}/conversations/{conversationId}/messages
Sends a message to conversation
post
Retrieves a conversation's messages from an point (event) in time and works backwards
get
/apispaces/{apiSpaceId}/conversations/{conversationId}/messages/statusupdates
Posts message updates back
post
Analytics API
/apispaces/{apiSpaceId}/analytics/conversationmessages
Retrieves conversation message analytics
get
/apispaces/{apiSpaceId}/analytics/messages
Retrieves message analytics
get
/apispaces/{apiSpaceId}/analytics/sessions
Retrieves session analytics
get
/apispaces/{apiSpaceId}/analytics/sms/tracking
Retrieves url tracking analytics
get
/apispaces/{apiSpaceId}/analytics/sms/verify
Retrieves sms verify analytics
get
/apispaces/{apiSpaceId}/analytics/sms/inbound
Retrieves inbound SMS analytics
get
/apispaces/{apiSpaceId}/analytics/sms/outbound
Retrieves outbound SMS analytics
get
Phone Number Validation API
/apispaces/{apiSpaceId}/phonevalidation/single
Validates a single phone number
get
Facebook API
Facebook Meta Data Service
post
Integrator API
Getting Message Statuses
get
Profile Schema Retrieval
get
Authenticate
post
API Space Management API
/apispaces/{id}
Retrieves an API Space
get
Updates an API Space
put
Deletes an API space
del
/apispaces
Retrieves all API Spaces accessible by the current user
get
Creates a new API Space
post
/apispaces/{id}/auth
Retrieves an API Space's authentication configuration
get
Updates an API Space's authentication configuration
put
/apispaces/{id}/push
Retrieves an API Space's push configuration
get
/apispaces/{id}/retention
Retrieves an API Space's data retention configuration
get
Updates an API Space's data retention configuration
put
/apispaces/{id}/push/apns
Updates an API Space's APNS push certificate configuration
put
/apispaces/{id}/push/apns/{bundleId}/{environment}
Deletes a specific bundle from an API Space's APNS push configuration
del
/apispaces/{id}/push/apns/{bundleId}/{environment}/cert
Retrieves a bundle's APNS certificate
get
/apispaces/{id}/push/apnstoken
Updates an API Space's APNS push token configuration
put
Deletes the APNS push token configuration from an API Space's APNS push configuration
del
/apispaces/{id}/push/apnstoken/key
Retrieves the APNS key file for the API Space
get
/apispaces/{id}/push/fcm/{package}
Updates an API Space's FCM push configuration
put
Deletes a specific package from an API Space's FCM push configuration
del
Billing API
/accounts/{accountId}/tariff
Retrieves an account's tariff
get
/accounts/{accountId}/transactions
Retrieves an account's transaction history. Spends such as monthly profile bill, SMS message sends, PNV lookups and SMS inbound numbers appear as debits, i.e. negative amounts. Invoice or card payments appear as positive credits to the account.
get
Session API
/apispaces/{apiSpaceId}/sessions/tokens/anon
Gets a token that can be used to start an anonymous session
get
/apispaces/{apiSpaceId}/sessions/{id}
Retrieves details about a session
get
Ends a session, revoking access to services.
del
Webhook API
/apispaces/{apiSpaceId}/webhooks
Retrieves a webhook configuration
get
Create a webhook configuration
post
/apispaces/{apiSpaceId}/webhooks/availableevents
Retrieves a webhook available events
get
/apispaces/{apiSpaceId}/accesstokens/availabletemplates
Gets a list of available events templates that the caller can use when creating webhook
get
/apispaces/{apiSpaceId}/webhooks/{webhookId}
Retrieves a webhook configuration
get
Updates a webhook configuration
put
Deletes a webhook configuration
del
Message Rules API
/apispaces/{apiSpaceId}/automation/inboundrules/optout
Retrieves a message opt out configuration list
get
Create a message opt out configuration
post
/apispaces/{apiSpaceId}/automation/inboundrules/optout/{messageRulesId}
Retrieves single message opt out configuration
get
Update single message opt out configuration
put
Delete single message rule configuration
del
/apispaces/{apiSpaceId}/automation/inboundrules
Retrieves a message rules configuration list
get
Create a message rule configuration
post
/apispaces/{apiSpaceId}/automation/inboundrules/{messageRulesId}
Retrieves single message rule configuration
get
Update single message rule configuration
put
Delete single message rule configuration
del
Chat API
/apispaces/{apiSpaceId}/chats/{chatId}
Retrieves a chat
get
Updates a chat
put
Deletes a chat
del
/apispaces/{apiSpaceId}/chats/{chatId}/assign
Assigns a chat
put
/apispaces/{apiSpaceId}/chats/{chatId}/close
Closes a chat
put
/apispaces/{apiSpaceId}/chats/{chatId}/channel
Changes the channel for an existing chat
put
/apispaces/{apiSpaceId}/chats/{chatId}/form
Sends a form to a chat
post
/apispaces/{apiSpaceId}/chats
Creates a new chat
post
Retrieves a list of chats
get
/apispaces/{apiSpaceId}/chats/{chatId}/typing
Indicates that the caller is typing in this chat
post
Indicates that the caller has stopped typing in this chat
del
/apispaces/{apiSpaceId}/chats/{chatId}/participants
Retrieves the chat participants
get
Chat Message API
/apispaces/{apiSpaceId}/chats/{chatId}/events
Retrieves a chat's events
get
/apispaces/{apiSpaceId}/chats/{chatId}/messages
Sends a message to chat
post
Retrieves a chat's messages from an point (event) in time and works backwards
get
/apispaces/{apiSpaceId}/chats/{chatId}/messages/statusupdates
Posts message updates back
post
Chat Presence API
/apispaces/{apiSpaceId}/presence
Retrieves the presence for a list of agent's profileIds
get
/apispaces/{apiSpaceId}/presence/away
Sets the profile identified in the JWT to be 'away'
post
Sets the profile identified in the JWT to be available
del
/apispaces/{apiSpaceId}/presence/appmessaging
Retrieves the presence for a list of user's profileIds
get
Chat Config API
/apispaces/{apiSpaceId}/chat/config
Retrieves the chat configuration for an apiSpace
get
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}
Retrieves the members of a team
get
Removes the config for a team
del
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/sms
Update the SMS config for a team
put
Removes the SMS config for a team
del
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/fbMessenger
Update the Facebook Messenger config for a team
put
Removes the Facebook Messenger config for a team
del
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/appMessaging
Update the App Messaging config for a team
put
Removes the App Messaging config for a team
del
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/email
Update the email config for a team
put
Removes the email config for a team
del
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/settings
Update general settings for a team
put
Removes the settings for a team
del
Reference
MIME Types
Calling the One API
Ask AI
