List profiles | BetterPost Docs

curl -s "https://api.betterpost.dev/v1/profiles?page=1&limit=50&name=acme" \
  -H "x-access-key: $BETTERPOST_API_KEY"

Profiles are listed oldest first. Unlike posts and accounts, this endpoint pages with page and limit (default 50, maximum 100). name filters by a case-insensitive substring. Each profile includes integrationCount, the number of accounts currently connected to it.

{
  "success": true,
  "total": 1,
  "page": 1,
  "limit": 50,
  "profiles": [
    {
      "id": "prof_1b7r4a9n2d5c8l0e3k6s9m2x",
      "name": "Acme Coffee",
      "description": "Brand accounts for Acme",
      "integrationCount": 2,
      "createdAt": "2026-10-21T14:03:12.418Z",
      "updatedAt": "2026-10-21T14:03:12.418Z"
    }
  ]
}

Reference: GET /v1/profiles.

curl -s "https://api.betterpost.dev/v1/profiles?page=1&limit=50&name=acme" \
  -H "x-access-key: $BETTERPOST_API_KEY"

{
  "success": true,
  "total": 1,
  "page": 1,
  "limit": 50,
  "profiles": [
    {
      "id": "prof_1b7r4a9n2d5c8l0e3k6s9m2x",
      "name": "Acme Coffee",
      "description": "Brand accounts for Acme",
      "integrationCount": 2,
      "createdAt": "2026-10-21T14:03:12.418Z",
      "updatedAt": "2026-10-21T14:03:12.418Z"
    }
  ]
}

Reference: GET /v1/profiles.