For AI agents: visit https://cpaas.developer.dotdigital.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI. Append .md to any documentation page URL to get its markdown version.
Jump to Content
Dotdigital Enterprise Communications APIGet StartedReferenceChangelog
HomeGet StartedReference
Get StartedReferenceChangelogSelect ProductPortalLog InDotdigital Enterprise Communications API
Reference
Select ProductPortalLog In

OAS and Swagger

  • Downloading OAS / Swagger specifications

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
      • Get SMS phone numbersget
      • Get SMS shortcodesget
      • Get SMS keywordsget
    • 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 Andorid SDK
    • 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

Phone Number Validation

  • Single number
    • Validate a single numberget
  • Bulk validation
    • List bulk validation jobs.get
    • Bulk validate numberspost
    • Get bulk job detailsget
    • Get bulk job resultsget

Enterprise Communications Message API

  • /apispaces/{apiSpaceId}/messages/{messageId}/statuses/{status}
    • Posts a status for a messagepost
  • /apispaces/{apiSpaceId}/messages/{messageId}
    • Retrieves the current state of a specific message.get
    • Deletes a Messagedel
    • Patches a Messagepatch
  • /apispaces/{apiSpaceId}/messages
    • Send a new messagepost
  • /apispaces/{apiSpaceId}/messages/batch
    • Send a batch of new messagespost
  • /apispaces/{apiSpaceId}/messages/inbounds
    • Posts an inbound messagepost
  • /apispaces/{apiSpaceId}/messages/inbounds/{inboundMessageId}/statuses/{status}
    • Posts a status for an inboundpost

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

Analytics API

  • App Messaging
    • Retrieves conversation message analyticsget
    • Retrieves session analyticsget
  • Chat
    • Retrieves chat analyticsget
    • Retrieves live chat analyticsget
  • Messaging
    • Retrieves message analyticsget
    • Retrieves message metricsget
  • SMS
    • Retrieves url tracking analyticsget
    • Retrieves sms verify analyticsget
    • Retrieves inbound SMS analyticsget
    • Retrieves outbound SMS analyticsget
  • WhatsApp
    • Retrieves WhatsApp conversation analyticsget
    • Retrieves WhatsApp business-initiated conversation analytics for the last 24 hours (Daily message usage)get

Content API

  • /apispaces/{apiSpaceId}/content/{fileId}
    • Retrieve a fileget

Message rules

  • /apispaces/{apiSpaceId}/automation/inboundrules/optout
    • Retrieves a message opt out configuration listget
    • Create a message opt out configurationpost
  • /apispaces/{apiSpaceId}/automation/inboundrules/optout/{messageRulesId}
    • Retrieves single message opt out configurationget
    • Update single message opt out configurationput
    • Delete single message rule configurationdel
  • /apispaces/{apiSpaceId}/automation/inboundrules
    • Retrieves a message rules configuration listget
    • Create a message rule configurationpost
  • /apispaces/{apiSpaceId}/automation/inboundrules/{messageRulesId}
    • Retrieves single message rule configurationget
    • Update single message rule configurationput
    • Delete single message rule configurationdel

Profile API

  • /apispaces/{apiSpaceId}/profiles/export
    • Exports the result of a profile query in a formatted file for downloadpost
  • /apispaces/{apiSpaceId}/profiles/bulk
    • Deletes the requested profilesdel
    • Creates or updates the supplied profiles with the supplied datapatch
  • /apispaces/{apiSpaceId}/profiles/{id}
    • Retrieves a Profileget
    • Updates or undeletes a Profileput
    • Deletes a Profiledel
    • Patches a Profilepatch
  • /apispaces/{apiSpaceId}/profiles/{id}/optin
    • Set profile opt in for specified channelsput
    • Set profile opt in for specified channelsdel
  • /apispaces/{apiSpaceId}/profiles/{id}/rels/primary/{linkedId}
    • Creates a relationship where the linked profile is the primary and this profile is a childput
    • Deletes the profile's relationship to a primary profiledel
  • /apispaces/{apiSpaceId}/profiles/{id}/rels/link/{linkedId}
    • Creates a relationship where this profile is the primary and the linked profile is a childput
    • Deletes the primary profile's relationship to a linked Profiledel
  • /apispaces/{apiSpaceId}/profiles/{id}/devices/{deviceId}
    • Removes device from profile and closes related opened sessionsdel
  • /apispaces/{apiSpaceId}/profiles/devices/push/validation
    • Retrieves push capabilities summarypost
  • /apispaces/{apiSpaceId}/profiles
    • Query profilesget
    • Creates a new Profilepost
  • /apispaces/{apiSpaceId}/profiles/import
    • Start the import processpost
  • /apispaces/{apiSpaceId}/profiles/optin
    • Gets default profiles opt in/out options for each channel in channel serviceget
    • Set default profiles opt in/out options for each channel in channel serviceput
  • /apispaces/{apiSpaceId}/profiles/import/{id}/duplicates
    • Get information about duplicated profilesget
  • /apispaces/{apiSpaceId}/profiles/import/{id}/start
    • Start the import processput
  • /apispaces/{apiSpaceId}/audiences/{id}
    • Retrieves an audienceget
    • Updates an audienceput
    • Deletes an audiencedel
  • /apispaces/{apiSpaceId}/audiences
    • Query audienceget
    • Creates a new audiencepost

Conversation API

  • /apispaces/{apiSpaceId}/conversations/{conversationId}
    • Retrieves a conversationget
    • Updates a conversationput
    • Deletes a conversationdel
  • /apispaces/{apiSpaceId}/conversations
    • Retrieves a list of conversationsget
    • Creates a new conversationpost
  • /apispaces/{apiSpaceId}/conversations/{conversationId}/typing
    • Indicates that the caller is typing in this conversationpost
    • Indicates that the caller has stopped typing in this conversationdel
  • /apispaces/{apiSpaceId}/conversations/{conversationId}/participants
    • Retrieves the conversation participantsget
    • Adds a list of participants to a conversationpost
    • Deletes a list of participants from a conversationdel

Conversation Message API

  • /apispaces/{apiSpaceId}/conversations/{conversationId}/events
    • Retrieves a conversation's eventsget
  • /apispaces/{apiSpaceId}/conversations/{conversationId}/messages
    • Retrieves a conversation's messages from an point (event) in time and works backwardsget
    • Sends a message to conversationpost
  • /apispaces/{apiSpaceId}/conversations/{conversationId}/messages/statusupdates
    • Posts message updates backpost

API Space Management API

  • /apispaces/{id}
    • Retrieves an API Spaceget
    • Updates an API Spaceput
    • Deletes an API spacedel
  • /apispaces
    • Retrieves all API Spaces accessible by the current userget
    • Creates a new API Spacepost
  • /apispaces/{id}/auth
    • Retrieves an API Space's authentication configurationget
    • Updates an API Space's authentication configurationput
  • /apispaces/{id}/push
    • Retrieves an API Space's push configurationget
  • /apispaces/{id}/retention
    • Retrieves an API Space's data retention configurationget
    • Updates an API Space's data retention configurationput
  • /apispaces/{id}/push/apns
    • Updates an API Space's APNS push certificate configurationput
  • /apispaces/{id}/push/apns/{bundleId}/{environment}
    • Deletes a specific bundle from an API Space's APNS push configurationdel
  • /apispaces/{id}/push/apns/{bundleId}/{environment}/cert
    • Retrieves a bundle's APNS certificateget
  • /apispaces/{id}/push/apnstoken
    • Updates an API Space's APNS push token configurationput
    • Deletes the APNS push token configuration from an API Space's APNS push configurationdel
  • /apispaces/{id}/push/apnstoken/key
    • Retrieves the APNS key file for the API Spaceget
  • /apispaces/{id}/push/fcm/v1/{package}
    • Updates an API Space's FCM push configurationput

Session API

  • /apispaces/{apiSpaceId}/sessions/tokens/anon
    • Gets a token that can be used to start an anonymous sessionget
  • /apispaces/{apiSpaceId}/sessions/{id}
    • Retrieves details about a sessionget
    • Ends a session, revoking access to services.del

Billing API

  • /accounts/{accountId}/tariff
    • Retrieves an account's tariffget

Webhook API

  • /apispaces/{apiSpaceId}/webhooks
    • Retrieves a webhook configurationget
    • Create a webhook configurationpost
  • /apispaces/{apiSpaceId}/webhooks/availableevents
    • Retrieves a webhook available eventsget
  • /apispaces/{apiSpaceId}/accesstokens/availabletemplates
    • Gets a list of available events templates that the caller can use when creating webhookget
  • /apispaces/{apiSpaceId}/webhooks/{webhookId}
    • Retrieves a webhook configurationget
    • Updates a webhook configurationput
    • Deletes a webhook configurationdel

WhatsApp Channel API

  • WhatsApp configurations
    • Get WhatsApp configuration for API Spaceget
    • Creates WhatsApp configurationpost
  • WhatsApp numbers
    • Get WhatsApp numberget
    • Removes WhatsApp numberdel
    • Registers WhatsApp numberpost
  • WhatsApp templates
    • Get WhatsApp templatesget
    • Get WhatsApp templateget

Chat API

  • /apispaces/{apiSpaceId}/chats/{chatId}
    • Retrieves a chatget
    • Updates a chatput
    • Deletes a chatdel
  • /apispaces/{apiSpaceId}/chats/{chatId}/assign
    • Assigns a chatput
  • /apispaces/{apiSpaceId}/chats/{chatId}/close
    • Closes a chatput
  • /apispaces/{apiSpaceId}/chats/{chatId}/channel
    • Changes the channel for an existing chatput
  • /apispaces/{apiSpaceId}/chats/{chatId}/form
    • Sends a form to a chatpost
  • /apispaces/{apiSpaceId}/chats
    • Retrieves a list of chatsget
    • Creates a new chatpost
  • /apispaces/{apiSpaceId}/chats/{chatId}/typing
    • Indicates that the caller is typing in this chatpost
    • Indicates that the caller has stopped typing in this chatdel
  • /apispaces/{apiSpaceId}/chats/{chatId}/participants
    • Retrieves the chat participantsget

Chat Message API

  • /apispaces/{apiSpaceId}/chats/{chatId}/events
    • Retrieves a chat's eventsget
  • /apispaces/{apiSpaceId}/chats/{chatId}/messages
    • Retrieves a chat's messages from an point (event) in time and works backwardsget
    • Sends a message to chatpost
  • /apispaces/{apiSpaceId}/chats/{chatId}/messages/statusupdates
    • Posts message updates backpost

Chat Config API

  • /apispaces/{apiSpaceId}/chat/config
    • Retrieves the chat configuration for an apiSpaceget
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}
    • Retrieves the members of a teamget
    • Removes the config for a teamdel
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}/sms
    • Update the SMS config for a teamput
    • Removes the SMS config for a teamdel
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}/fbMessenger
    • Update the Facebook Messenger config for a teamput
    • Removes the Facebook Messenger config for a teamdel
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}/appMessaging
    • Update the App Messaging config for a teamput
    • Removes the App Messaging config for a teamdel
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}/email
    • Update the email config for a teamput
    • Removes the email config for a teamdel
  • /apispaces/{apiSpaceId}/chat/config/teams/{teamId}/settings
    • Update general settings for a teamput
    • Removes the settings for a teamdel

Partner : Reseller API

  • Partner/Reseller API Overview
  • Accounts
    • Add Accountpost
    • Get Accountspost
    • Get Account Detailspost
    • Update Account Detailspost
    • Delete Accountpost
    • Get Market Sectorspost
  • Users
    • Get Userspost
    • Get User Detailspost
    • Update User Detailspost
    • Password Resetpost
    • Delete Userpost
    • Undelete Userpost
    • Add User to Accountpost
  • Billing
    • Get Chargeable Activitypost
    • Get Account Creditpost
    • Adjust Creditpost
    • Add Creditpost
    • Get Account Credit Bundlespost
  • Security
    • Get Available Rolespost
    • Get Default Rolespost
    • Set Default Rolespost
    • Get User Rolespost
    • Add Role to Userpost
    • Remove Role from Userpost
  • Numbers
    • Get Inbound Numberspost
    • Allocate Inbound Numberpost
    • Deallocate Inbound Numberpost

Authentication

  • Authenticatepost

Reference

  • MIME Types

/apispaces/{apiSpaceId}/profiles/{profileId}/messages

Use this method to retrieve the full cross channel messaging history for a profile.

Updated 10 months ago


Posts a status for an inbound
Retrieves message history for the specified profile. Messages retrieved from the date spacified (default now), in descending time order.

Updated 10 months ago


Posts a status for an inbound
Retrieves message history for the specified profile. Messages retrieved from the date spacified (default now), in descending time order.