Create New Account User(s)

POST https://restapi.actonsoftware.com/api/1/user

This endpoint allows you to create a new user or multiple users to the account.

Parameters

Name Parameter
Type
Allow
Multiple
Required/
Optional
Data Type Description
Authorization: Header False Required String Insert your generated access token.
("Bearer {access token}")
Body false Required String A RAW body with JSON containing the userspecs data.

See userspecs documentation for details on how to create the JSON required for the body of this request.

Response

The users are created independently and a failure of one user will not prevent other users from being created. The status of “ok” or “error” along with an email will indicate if the user was added successfully or not.

[
  {
    "email": "john.doe@act-on.com",
    "status": "ok",
    "privilegeResponses": [],
    "confirmationEmailResponse": {
      "email": "john.doe@act-on.com",
      "status": "ok"
    }
  }
]

In the above response example, the user john.doe@act-on.com did not have specified user privileges so the element is empty and the user received all the default settings.

Code Examples

cURLPython

curl -X POST https://restapi.actonsoftware.com/api/1/user -H 'authorization: Bearer 6e8bfa02-0036-306d-893b-02246f52288d' -H 'content-type: application/json' -d '[{"userType":"Marketing","email":"john.doe@act-on.com","firstName":"John","lastName":"Doe","password":"password","title":"Marketing Manager","phoneNumber":"555-555-5555","mobileNumber":"555-555-5555","faxNumber":"555-555-5555","timeZone":"PT","sendEmailConfirmation":"Y"}]'

import requests

url = "https://restapi.actonsoftware.com/api/1/user"

payload = "[{\"userType\":\"Marketing\",\"email\":\"john.doe@act-on.com\",\"firstName\":\"John\",\"lastName\":\"Doe\",\"password\":\"password\",\"title\":\"Marketing Manager\",\"phoneNumber\":\"555-555-5555\",\"mobileNumber\":\"555-555-5555\",\"faxNumber\":\"555-555-5555\",\"timeZone\":\"PT\",\"sendEmailConfirmation\":\"Y\"}]"

headers = {
    'authorization': "Bearer b9497249-5bd4-3a86-9494-b1bfe2cee147",
    'content-type': "application/json",
         }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)