Users API

Create a viewer user

POST /api/v1/products/:product_id/users

Parameters
NameDescription
product_id *

Numeric ID or key of the product

first_name *

First name of the user to be created

last_name *

Last name of the user to be created

email *

Email of the user to be created

role *

Permissions of the user to be created in the product one of: product_owner, contributor, reviewer, viewer, none

identity_provider_id

The ID of the identity provider that will be used for this user. Not required if user will use a password.

Example request

POST /api/v1/products/PRJ1/users

Example CURL command

curl "https://company.aha.io/api/v1/products/PRJ1/users" -d '{"user":{"email":"[email protected]","first_name":"sam","last_name":"doe","role":"viewer"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Authorization: Bearer 584b6d6b83405011f8c6903d2379f4afdf824cef867db391b7bcb5995f603a76"

Request

contentType: application/json
accept: application/json
authorization: Bearer 584b6d6b83405011f8c6903d2379f4afdf824cef867db391b7bcb5995f603a76

Request body

Response

Status: 200 OK
contentType: application/json; charset=utf-8

Response body