Substy Developers
Creator connections

Verify creator login code

Submit the 2FA code the account owner received for a login that returned mfaChallenge (MYM), with its pendingConnectId. status=connected returns the connected or reconnected creatorId. status=refused with reason code_invalid allows another attempt; code_expired, account_locked, too_many_attempts and login_failed require a new connect_creator_account login. Only the user who started the login can complete it.

POST/v1/agencies/{agencyId}/creator-connections/mfa-verifications

Submit the 2FA code the account owner received for a login that returned mfaChallenge (MYM), with its pendingConnectId. status=connected returns the connected or reconnected creatorId. status=refused with reason code_invalid allows another attempt; code_expired, account_locked, too_many_attempts and login_failed require a new connect_creator_account login. Only the user who started the login can complete it.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agencies/string/creator-connections/mfa-verifications" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "pendingConnectId": "string",    "code": "string"  }'
{  "data": {    "status": "connected",    "creatorId": "string"  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Connect creator account POST

Connect a creator account using the supported platform credentials. The result reports connection progress and any required verification step; it never returns stored connection secrets. An OnlyFans account that needs a second factor returns creatorId with twoFaState: continue with send_creator_connection_code, verify_creator_connection_code or start_creator_face_verification. A MYM account with 2FA returns mfaChallenge and no creatorId: ask the account owner for the code sent to mfaChallenge.destination and submit it with verify_creator_login_code within 3 minutes.

Resend creator login code POST

Send a new 2FA code for a login that returned mfaChallenge (MYM), once its resend wait is over. status=pending returns the refreshed mfaChallenge; status=refused with reason resend_cooldown reports retryAfterSeconds. Only the user who started the login can resend.