Documentation

User API

Quickstart

In this guide we will show you how to:

  1. Create a user
  2. Update a user’s information
  3. Delete a user from Domo

Once a user is created, you can then make updates to the user’s information displayed in the Domo application as well as the user’s role which grants permission to functionality throughout each Domo feature.

NOTE: In order to follow this Quickstart you will need to obtain an access token or you can leverage any of Domo’s SDKs which will also handle authentication.

Step 1: Create a user

Sample Request

See it in your language

See this sample request in Java, Python.
POST /v1/users?sendInvite=true HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api.domo.com
Content-Length: 90
Authorization: bearer <your-valid-oauth-access-token>

{
"title": "Software Engineer",
"email": "leonhard.euler@domo.com",
"alternateEmail": "leonhardeuler@email.com",
"role": "Admin",
"phone": "888-555-0123",
"name": "Leonhard Euler",
"location": "American Fork",
"timezone": "",
"locale": "",
"employeeNumber": 23432
}

Make sure to store the user_id value with the user's name in order to make updates to user information, the user's role in Domo, or adding access rights to data within a DataSet or content found in a Domo Page or Card.

Step 2: Update a user's information

With a new user_id, update the user's information:

Sample Request

See it in your language

See this sample request in Java, Python.
PUT /v1/users/855462682 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api.domo.com
Content-Length: 41
Authorization: bearer <your-valid-oauth-access-token>

{
  "email": "leonhard.euler@domo.com",
  "role": "Admin",
  "name": "Leonhard Euler"
}

Step 3: Delete a user from Domo

Similar to updating a user's information, provide the correct user_id when attempting to delete the user from Domo:

Sample Request

See it in your language

See this sample request in Java, Python.
DELETE /v1/users/855462682 HTTP/1.1
Accept: application/json
Host: api.domo.com
Authorization: bearer <your-valid-oauth-access-token>

Next steps

Congrats. you’ve just created and then deleted a user in Domo.

You may want to learn how to manage users in more detail or explore these other topics:



Need additional help?

No problem, we'd love to help. Explore additional guides and articles or join other developers in Domo's Developer Forum.  For further help, feel free to email us or contact our sales team.