Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/create

​
Overview

Create one or more new account seats for your organization. This endpoint automatically updates your Stripe subscription billing based on the tier of each account.
  • If only tier is provided, the account is created with status uninitialized
  • If all detail fields (tier, platform, username, pfp_url, keywords) are provided, the account is created with status pending and will begin setup automatically
  • If some but not all detail fields are provided, a 400 error is returned

​
Request Body

​
accounts
array
required
Array of accounts to create. Each account object contains:
When providing account details, all four fields (platform, username, pfp_url, keywords) must be present. Providing some but not all will result in a 400 error.

​
Response

​
data
object
Response object containing success summary and created accounts
curl -X POST https://api.ugc.inc/accounts/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [
      {
        "tier": "basic"
      },
      {
        "tier": "premium",
        "platform": "tiktok",
        "username": "newcreator",
        "pfp_url": "https://example.com/avatar.jpg",
        "keywords": "fitness,health,workout",
        "nick_name": "New Creator",
        "tag": "influencer"
      }
    ]
  }'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "message": "Successfully created 2 account(s)",
    "successful": 2,
    "failed": 0,
    "accounts": [
      {
        "id": "acc_123456",
        "tier": "basic",
        "status": "uninitialized",
        "platform": null,
        "username": null
      },
      {
        "id": "acc_789012",
        "tier": "premium",
        "status": "pending",
        "platform": "tiktok",
        "username": "newcreator"
      }
    ]
  }
}