MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Verify Account Onboard OTP

Use this endpoint to verify the one-time password (OTP) that was sent to an account email using the Request Account Onboard OTP endpoint. Once verified, Marmin confirms that the account owner has approved onboarding under your partner integration. The OTP is valid for 2 minutes from the time it is issued, and verification attempts after that window will fail.

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
emailstring
Required
The account email that received the onboarding OTP (for example, user@example.com). Must match the email used when requesting the OTP.
otpstring
Required
The one-time password that was sent to the account email and entered by the account owner.
Response

Status code: 200 OK

Returns an object with identifiers for the user and organization that were onboarded.

Response body
FieldTypeDescription
user_idstringThe identifier of the user that was created as part of onboarding.
org_idstringThe identifier of the organization that was provisioned under your partner integration.
Error responses
StatusDescription
400 Bad RequestThe request body is invalid, required fields are missing, or the OTP format is incorrect.
401 UnauthorizedAuthentication required, the JWT is invalid, or it was not issued for a partner client.
403 ForbiddenThe authenticated partner is not allowed to verify onboarding for this account.
404 Not FoundNo pending onboarding request was found for the provided email.
409 ConflictThe OTP is invalid or expired, or the account has already been onboarded.
500 Internal Server ErrorAn error occurred while processing the request.
Next