/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
Acceptapplication/json
AuthorizationBearer <your token>Bearer wV1MLk5+sFzioJw/3M5r9A==
Content-Typeapplication/json

Fields

Field
Type
Optional
Description
codeStringOptionalA unique code that correlates the user to an external database (maximum 191 chars); correlates to X-UserCode
firstNameStringRequired
lastNameStringRequired
emailStringRequiredThe email address of the user (we will not send email to your user)
localeStringOptionalThe 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"
}