MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Obtain Account Access Token

Use this endpoint to obtain an access token scoped to a specific customer organization so that you can perform API operations on behalf of that customer under your partner integration.

See the right panel for the base URL, request samples, and response JSON.

Authentication

This endpoint requires a JWT access token issued to your partner integration:

  • Obtain the token using your partner client_id and client_secret (see Authentication overview).

  • Pass the token in the Authorization header as Bearer <partner_jwt_token>.

Request body
FieldTypeRequiredDescription
org_idstring
Required
The identifier of the customer organization you want to act on behalf of (for example, d196eb3c-319e-4957-894c-424d5f2181f0).
Response

Status code: 200 OK

Returns an access token you can use to make API calls as the specified customer organization.

Response body
FieldTypeDescription
tokenstringThe access token to use when calling other Marmin APIs on behalf of this customer.
expires_innumberThe lifetime of the access token in seconds.

Use the returned `token` in the `Authorization` header (`Bearer <token>`) when calling other Marmin APIs on behalf of this customer.

Next (partner onboarding): Call Request BP claim OTP, then Claim BP with OTP, using this account-scoped token.

Error responses
StatusDescription
400 Bad RequestThe request body is invalid, required fields are missing, or the org_id format is incorrect.
401 UnauthorizedAuthentication required, the partner JWT is invalid, or it was not issued for a partner client.
403 ForbiddenThe authenticated partner is not allowed to obtain an access token for this organization.
404 Not FoundNo customer organization was found for the provided org_id.
500 Internal Server ErrorAn error occurred while processing the request.
Next