PAparley
Accounts

Create an account

Changed on

Create an account (a client organization), optionally linked to projects. A contact joins an account through its accountId.

post/accounts

Request

  • Base URL
    https://api.parley.so/v1
  • URL
    https://api.parley.so/v1/accounts
  • Auth
    HTTP bearer

Request body

namestring required

Account name.

projectIdsstring[]

IDs of projects to link. At most 100. Each project must be one you can edit.

fieldsobject

Custom field values to set on the account, keyed by field name or ID. A value replaces the current one, null clears it, and fields you don't mention are left alone. Each value must match its field's type: a string for text, long_text, email, url, single_select (one of the field's options), and user (the id of an active user in the organization); a number; true or false; an ISO 8601 date-time or YYYY-MM-DD date; a list of strings for collection ([] clears it); or { streetAddress, cityTown, state, country } for address. At most 50 fields.

Response

Created.

idstring required

The account ID.

namestring required

Account name.

contactCountinteger required

How many contacts belong to the account. List them by filtering contacts by accountId.

projectCountinteger required

How many projects you can see are linked directly to the account. Filtering projects by accountId also returns the projects linked through the account's contacts. Linking or unlinking a project doesn't change the account's updatedAt.

createdAtstring date-time required

When the account was created.

updatedAtstring date-time required

When the account itself was last updated. Contacts joining or leaving the account, links to projects, and field value changes do not change it.

fieldsobject required

Custom field values, keyed by field name, with a key for every field defined for accounts (null when unset). The value's shape follows the field's type.

Example response

{
  "id": "cmf2x7r1p0000abcd",
  "name": "Acme Corp",
  "contactCount": 3,
  "projectCount": 2,
  "createdAt": "2026-09-12T10:00:00.000Z",
  "updatedAt": "2026-09-12T10:00:00.000Z",
  "fields": {
    "Web Address": [
      "acme.example"
    ],
    "Overview": null
  }
}

Changes