Users

Create and Invite User

POST

Creates and invites a new user to your account.

Request

This endpoint expects an object.

stringRequired

name

stringRequired

actorRoles

list of objectsRequired

Response

This endpoint returns an object

data

object

POST

1 curl -X POST https://api.x.flatfile.com/v1/users/invite \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "email": "john.smith@example.com",
6   "name": "John Smith",
7   "actorRoles": [
8     {
9       "roleId": "us_rol_YOUR_ID",
10       "resourceId": "us_acc_YOUR_ID"
11     },
12     {
13       "roleId": "us_rol_YOUR_ID",
14       "resourceId": "us_env_YOUR_ID"
15     }
16   ]
17 }'

200Successful

1 {
2   "data": {
3     "accountId": "us_acc_YOUR_ID",
4     "actorRoles": [
5       {
6         "id": "us_acr_YOUR_ID",
7         "roleId": "us_rol_YOUR_ID",
8         "actorId": "us_usr_YOUR_ID",
9         "resourceId": "us_acc_YOUR_ID",
10         "createdAt": "2021-01-01T00:00:00Z",
11         "updatedAt": "2021-01-01T00:00:00Z"
12       },
13       {
14         "id": "us_acr_YOUR_ID",
15         "roleId": "us_rol_YOUR_ID",
16         "actorId": "us_ag_YOUR_ID",
17         "resourceId": "us_env_YOUR_ID",
18         "createdAt": "2021-01-01T00:00:00Z",
19         "updatedAt": "2021-01-01T00:00:00Z"
20       }
21     ],
22     "createdAt": "2023-10-30T16:59:45.735Z",
23     "email": "john.smith@example.com",
24     "id": "us_usr_YOUR_ID",
25     "idp": "FRONTEGG",
26     "metadata": {},
27     "name": "john.smith",
28     "updatedAt": "2023-10-30T16:59:45.735Z",
29     "dashboard": 2,
30     "idpRef": "ab1cf38e-e617-4547-b37d-376a7ac9e554",
31     "lastSeenAt": "2023-10-30T16:59:45.735Z"
32   }
33 }

Built with

1	curl -X POST https://api.x.flatfile.com/v1/users/invite \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"email": "john.smith@example.com",
6	"name": "John Smith",
7	"actorRoles": [
8	{
9	"roleId": "us_rol_YOUR_ID",
10	"resourceId": "us_acc_YOUR_ID"
11	},
12	{
13	"roleId": "us_rol_YOUR_ID",
14	"resourceId": "us_env_YOUR_ID"
15	}
16	]
17	}'

1	{
2	"data": {
3	"accountId": "us_acc_YOUR_ID",
4	"actorRoles": [
5	{
6	"id": "us_acr_YOUR_ID",
7	"roleId": "us_rol_YOUR_ID",
8	"actorId": "us_usr_YOUR_ID",
9	"resourceId": "us_acc_YOUR_ID",
10	"createdAt": "2021-01-01T00:00:00Z",
11	"updatedAt": "2021-01-01T00:00:00Z"
12	},
13	{
14	"id": "us_acr_YOUR_ID",
15	"roleId": "us_rol_YOUR_ID",
16	"actorId": "us_ag_YOUR_ID",
17	"resourceId": "us_env_YOUR_ID",
18	"createdAt": "2021-01-01T00:00:00Z",
19	"updatedAt": "2021-01-01T00:00:00Z"
20	}
21	],
22	"createdAt": "2023-10-30T16:59:45.735Z",
23	"email": "john.smith@example.com",
24	"id": "us_usr_YOUR_ID",
25	"idp": "FRONTEGG",
26	"metadata": {},
27	"name": "john.smith",
28	"updatedAt": "2023-10-30T16:59:45.735Z",
29	"dashboard": 2,
30	"idpRef": "ab1cf38e-e617-4547-b37d-376a7ac9e554",
31	"lastSeenAt": "2023-10-30T16:59:45.735Z"
32	}
33	}