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": "[email protected]", "status": "ok", "privilegeResponses": [], "confirmationEmailResponse": { "email": "[email protected]", "status": "ok" } } ]
In the above response example, the user [email protected] did not have specified user privileges so the element is empty and the user received all the default settings.
Code Examples
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":"[email protected]","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\":\"[email protected]\",\"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)