The Data Talks API provides a way for our customers to integrate and send data from multiple systems through a single endpoint. The supported integration can be enabled or disabled for customers, and the way data is organized and sent to the different systems is controlled via mappings. This documentation aims to describe and explain what the currently supported integrations are, how to authenticate and use the API, and how to define the mappings for an integration.
If you want to test API out in a safe environment you can use the staging endpoints:
If the payload is supposed to be sent to Salesmanago, groupKey field must be filled (see v1 documentation).
A group key is our internal way to group your integrations. This is useful if you have multiple brands or markets and have different accounts in the integration systems and you want to send separate API requests to them. In case you don’t have such, you will have only one group_key to work with. Make sure that the group_key is sent in every request.
datatalksId - optional parameter field (see Basic Concepts section).
success = true/false,
messages = [""],
requestId = requestId,
datatalksId = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,
key = yourAwsKey,
Datatalks ID is a UUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) that is automatically generated, stored and returned for every entity processed by API.
Data Talks should create a Datatalks ID for every customer that arrives in our systems through API, files, or third-party systems. The Datatalks ID is the master id and all potential IDs coming from the source systems should belong to this one as secondary IDs. Different customers can have different requirements when it comes to the Unique Id that they can send to us. Some have email as the unique id while some of them have a CRM id as the unique identifier.
You can describe (map) the entities (Events, Profiles, and Inventories – see Endpoints). As long as it suits the data types that Data Talks CDP accepts, you can define as many fields as you like and the way they will look like. Therefore the following can be defined: the name of the source field, the name of the field to appear in Data Talks CDP, the data type (respecting the limitations), and the format of the data.
Mappings should be defined per each entity (datapoint type) on the onboarding stage, before start using API.
Any unmapped payload field will be ignored by default.
Any missing field will lead to 400 – Bad Request API response. Except for the fields marked as Optional.
To build the Authorization header you will need AWS IAM account credentials – ACCESS_KEY_ID and SECRET_ACCESS_KEY. When requesting access to our API an account will be created for you by our team and the credentials will be sent to you.
The authentication of the API is implemented via AWS IAM. When making an API request you will have to authenticate via AWS Signature Version 4. Here is an example of an Authorization header done with AWS Signature Version 4:
To build the Authorization header you will need an AWS IAM account credentials – ACCESS_KEY_ID and SECRET_ACCESS_KEY. When requesting access to our API an account will be created for you by our team and the credentials will be sent to you.
Signature Version 4 Signing Process
Powered by BetterDocs
We use browser cookies that are necessary for the site to work as intended.
For example, we store your website data collection preferences so we can honor them if you return to our site. You can disable these cookies in your browser settings but if you do the site may not work as intended.
To personalize and measure the effectiveness of advertising on our site and other websites.
For example, we may serve you a personalized ad based on the pages you visit on our site.
To understand user behavior in order to provide you with a more relevant browsing experience or personalize the content on our site.
For example, we collect information about whic pages you visit to help us present more relevante information.
To monitor the performance of our site and to enhance your browsing experience.
For example, these tools enable you to communicate with us via live chat.