Create entity user | Mercoa

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

entityIdstringRequired

Entity ID or Entity ForeignID

This endpoint expects an object.

foreignIdstringOptional

The ID used to identify this user in your system.

emailstringOptional

namestringOptional

roleslist of stringsOptional

List of roles. A role can be any string. For example: “payer”, “approver”, “viewer”

This endpoint returns an object.

idstring

roleslist of strings

createdAtdatetime

updatedAtdatetime

foreignIdstring

The ID used to identify this user in your system.

emailstring

namestring

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

501

Unimplemented

$	curl -X POST https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/user \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"foreignId": "MY-DB-ID-12345",
>	"email": "john.doe@acme.com",
>	"name": "John Doe",
>	"roles": [
>	"admin",
>	"approver"
>	]
>	}'

$	curl -X POST https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/user \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"foreignId": "MY-DB-ID-12345",
>	"email": "john.doe@acme.com",
>	"name": "John Doe",
>	"roles": [
>	"admin",
>	"approver"
>	]
>	}'