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
{
"locale": "en",
"firstName": "Fred",
"id": 13,
"dmtdAdministrator": false,
"code": "Code: 1234",
"email": "fred@example.com",
"updatedAt": "2019-06-25T09:39:54Z",
"emailVerified": true,
"createdAt": "2019-06-25T09:39:54Z",
"lastName": "Flintstone"
}