Generate JWT Token | Mercoa

Generate a JWT token for an entity with the given options. This token can be used to authenticate the entity in the Mercoa API and iFrame. <Warning>We recommend using [this endpoint](/api-reference/entity/user/get-token). This will enable features such as approvals and comments.</Warning>

Generate a JWT token for an entity with the given options. This token can be used to authenticate the entity in the Mercoa API and iFrame.

We recommend using this endpoint. This will enable features such as approvals and comments.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequired

Entity ID or Entity ForeignID

Request

This endpoint expects an object.

expiresInstringOptional

Expressed in seconds or a string describing a time span. The default is 1h.

invoiceobjectOptional

pagesobjectOptional

styleobjectOptional

vendorsobjectOptional

entityobjectOptional

sessionIdstringOptional

Optional session ID to use for the token. If not provided, this token will not be associated with a session.

Response

This endpoint returns a string.

Errors

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

501

Unimplemented

Generate a JWT token for an entity with the given options. This token can be used to authenticate the entity in the Mercoa API and iFrame.

We recommend using this endpoint. This will enable features such as approvals and comments.

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

Entity ID or Entity ForeignID

This endpoint expects an object.

Expressed in seconds or a string describing a time span. The default is 1h.

Optional session ID to use for the token. If not provided, this token will not be associated with a session.

This endpoint returns a string.

$	curl -X POST https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/token \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"expiresIn": "1h"
>	}'

$	curl -X POST https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/token \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"expiresIn": "1h"
>	}'