Create a profile | BetterPost Docs

A profile is a named group of connected accounts inside a project, for example one per brand, client or end user of your app. Profiles are optional: accounts can also live outside any profile.

Use profiles to:

connect accounts straight into a group (profileId on connect);
list one group's accounts (GET /v1/connect/integrations?profileId=...);
scope webhooks and usage to one group.

curl -s -X POST https://api.betterpost.dev/v1/profiles \
  -H "x-access-key: $BETTERPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Coffee", "description": "Brand accounts for Acme" }'

{
  "success": true,
  "profile": {
    "id": "prof_1b7r4a9n2d5c8l0e3k6s9m2x",
    "name": "Acme Coffee",
    "description": "Brand accounts for Acme",
    "integrationCount": 0,
    "createdAt": "2026-10-21T14:03:12.418Z",
    "updatedAt": "2026-10-21T14:03:12.418Z"
  }
}

name is required (1 to 200 characters); description is optional (up to 1,000). Profiles are free.

Reference: POST /v1/profiles.

A profile is a named group of connected accounts inside a project, for example one per brand, client or end user of your app. Profiles are optional: accounts can also live outside any profile.

Use profiles to:

connect accounts straight into a group (profileId on connect);
list one group's accounts (GET /v1/connect/integrations?profileId=...);
scope webhooks and usage to one group.

curl -s -X POST https://api.betterpost.dev/v1/profiles \
  -H "x-access-key: $BETTERPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Coffee", "description": "Brand accounts for Acme" }'

{
  "success": true,
  "profile": {
    "id": "prof_1b7r4a9n2d5c8l0e3k6s9m2x",
    "name": "Acme Coffee",
    "description": "Brand accounts for Acme",
    "integrationCount": 0,
    "createdAt": "2026-10-21T14:03:12.418Z",
    "updatedAt": "2026-10-21T14:03:12.418Z"
  }
}

name is required (1 to 200 characters); description is optional (up to 1,000). Profiles are free.

Reference: POST /v1/profiles.