Substy Developers
Account and agency

Get agency access

Read the connected account's role, permissions and creator scope for the requested agency. The agency must match the approved MCP agency.

GET/v1/agencies/{agencyId}/access

Read the connected account's role, permissions and creator scope for the requested agency. The agency must match the approved MCP agency.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/access" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": {    "agencyId": "string",    "userId": "string",    "isOwner": true,    "role": null,    "permissions": [      "string"    ],    "dataVisibility": "SELF",    "creatorScope": "ALL",    "accessibleCreatorIds": [      "string"    ]  },  "meta": {    "requestId": "string"  }}

Get my agency access GET

Read the signed-in account, current agency role, permission keys and accessible creators. Use this to understand which platform actions the connected account can perform.

Get creator platform profile GET

Read the creator's public profile and editable profile settings from the connected platform.