Substy Developers
Creator connections

Connect creator account

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.

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

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.

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" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "email": "[email protected]",    "password": "string",    "platform": "ONLYFANS"  }'
{  "data": {    "requires2fa": true,    "creatorId": null,    "twoFaState": null,    "mfaChallenge": null  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

List agency creators GET

List creators belonging to the current agency, optionally filtering pending accounts. Results respect current creator access.

Verify creator login code POST

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.