Profiles

Get

Retrieve a single profile, including the count of active integrations bound to it.

Endpoint

GET https://api.postpeer.dev/v1/profiles/{id}

Path Parameters

Parameter	Type	Description
`id`	string	Profile ID

Example

curl "https://api.postpeer.dev/v1/profiles/65ab123" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "success": true,
  "profile": {
    "id": "65ab...",
    "name": "Acme Co",
    "description": "Marketing accounts",
    "integrationCount": 3,
    "createdAt": "2026-05-03T08:33:36.445Z",
    "updatedAt": "2026-05-03T08:33:36.445Z"
  }
}

Status Codes

Code	Meaning
`200`	Success
`400`	Invalid profile id
`404`	Profile not found

List

List all active profiles for your project, paginated and ordered newest-first.

Update

Update a profile's name, description, or color.

On this page

Path Parameters