/1/user - POST
Overview
The /1/user endpoint provides for the creation of new users.
Beta API
NOTE: This API is currently in beta and applies only to the 'iFrame' API customers.
Endpoint Details
Required Headers
Key | Value | Example |
---|---|---|
User-Agent | <company identifier> | The exact value here is not important, but it should include something to identify your company |
Accept | application/json | |
Authorization | Bearer <your token> | Bearer wV1MLk5+sFzioJw/3M5r9A== |
Content-Type | application/json |
Fields
Field | Type | Optional | Description |
---|---|---|---|
code | String | Optional | A unique code that correlates the user to an external database (maximum 191 chars); correlates to X-UserCode |
firstName | String | Required | |
lastName | String | Required | |
String | Required | The email address of the user (we will not send email to your user) | |
locale | String | Optional | The locale that the user prefers (default: 'en') |
Example
Example
curl -X POST \
-H 'User-Agent: dmtd-rest-api' \
-H 'Authorization: Bearer L2Hth4lRwgHRBWtX8Hkl5w==' \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "code": "Code: 1234", "firstName": "Fred", "lastName": "Flintstone", "email": "fred@example.com" }' \
https://api-sandbox.datamtd.com/1/user
Response
{
"id": 13,
 "code": "Code: 1234",
"firstName": "Fred",
 "lastName": "Flintstone",
"email": "fred@example.com",
 "locale": "en"
}