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
Retrieves an account's tariff
Search
JUMP TO
Enterprise Communications API
Enterprise Communications API overview
Call the Enterprise Communications API
Address 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
MMS
Push
WhatsApp
Facebook
App messaging
Custom channels
Branch
Webhooks
Webhooks
Message events
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
Install the SDK
Initialise
Start session
Client APIs
Listen to events
Push messages
Messaging service
Profile service
iOS
Install 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
Install 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
Install the SDK
Initialise
Chat store
Start session
Profile services
Messaging services
Listen to events
Client APIs
SMS
SMS API overview
SMS Reference
SMS encoding
SMS message segmentation
SMS message statuses
Verify
Verify API
Create and send a code
Validate code
Error codes
Enterprise Communications Message 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
delete
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
Deletes the requested profiles
delete
Creates or updates the supplied profiles with the supplied data
patch
/apispaces/{apiSpaceId}/profiles/{id}
Retrieves a Profile
get
Updates or undeletes a Profile
put
Deletes a Profile
delete
Patches a Profile
patch
/apispaces/{apiSpaceId}/profiles/{id}/optin
Set profile opt in for specified channels
put
Set profile opt in for specified channels
delete
/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
delete
/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
delete
/apispaces/{apiSpaceId}/profiles/{id}/devices/{deviceId}
Removes device from profile and closes related opened sessions
delete
/apispaces/{apiSpaceId}/profiles/devices/push/validation
Retrieves push capabilities summary
post
/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
delete
/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
delete
/apispaces/{apiSpaceId}/conversations
Retrieves a list of conversations
get
Creates a new conversation
post
/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
delete
/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
delete
Conversation Message API
/apispaces/{apiSpaceId}/conversations/{conversationId}/events
Retrieves a conversation's events
get
/apispaces/{apiSpaceId}/conversations/{conversationId}/messages
Retrieves a conversation's messages from an point (event) in time and works backwards
get
Sends a message to conversation
post
/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
API Space Management API
/apispaces/{id}
Retrieves an API Space
get
Updates an API Space
put
Deletes an API space
delete
/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
delete
/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
delete
/apispaces/{id}/push/apnstoken/key
Retrieves the APNS key file for the API Space
get
/apispaces/{id}/push/fcm/v1/{package}
Updates an API Space's FCM push configuration
put
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.
delete
Billing API
/accounts/{accountId}/tariff
Retrieves an account's tariff
get
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
delete
Chat API
/apispaces/{apiSpaceId}/chats/{chatId}
Retrieves a chat
get
Updates a chat
put
Deletes a chat
delete
/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
Retrieves a list of chats
get
Creates a new chat
post
/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
delete
/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
Retrieves a chat's messages from an point (event) in time and works backwards
get
Sends a message to chat
post
/apispaces/{apiSpaceId}/chats/{chatId}/messages/statusupdates
Posts message updates back
post
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
delete
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/sms
Update the SMS config for a team
put
Removes the SMS config for a team
delete
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/fbMessenger
Update the Facebook Messenger config for a team
put
Removes the Facebook Messenger config for a team
delete
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/appMessaging
Update the App Messaging config for a team
put
Removes the App Messaging config for a team
delete
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/email
Update the email config for a team
put
Removes the email config for a team
delete
/apispaces/{apiSpaceId}/chat/config/teams/{teamId}/settings
Update general settings for a team
put
Removes the settings for a team
delete
Partner / Reseller API
Partner/Reseller API Overview
Accounts
Add Account
post
Get Accounts
post
Get Account Details
post
Update Account Details
post
Delete Account
post
Get Market Sectors
post
Users
Get Users
post
Get User Details
post
Update User Details
post
Password Reset
post
Delete User
post
Undelete User
post
Add User to Account
post
Billing
Get Chargeable Activity
post
Get Account Credit
post
Adjust Credit
post
Add Credit
post
Get Account Credit Bundles
post
Security
Get Available Roles
post
Get Default Roles
post
Set Default Roles
post
Get User Roles
post
Add Role to User
post
Remove Role from User
post
Numbers
Get Inbound Numbers
post
Allocate Inbound Number
post
Deallocate Inbound Number
post
Authentication
Authenticate
post
Reference
MIME Types
Retrieves an account's tariff
get
https://api.comapi.com/accounts/
{accountId}
/tariff
Language
Shell
Node
Ruby
PHP
Python
Credentials
Bearer
JWT
Bearer
RESPONSE
Click
Try It!
to start a request and see the response here!