CapableDocs

Search the API docs

Find an endpoint or guide

Get an API key

StakeholdersCreate a stakeholder

Stakeholders

Create a stakeholder

Add a person or entity to the register, for example a new hire from your HRIS.
POST/api/v1/stakeholders

Requires an API key with the stakeholders:write scope · How keys work

Body

Send JSON with Content-Type: application/json.

  • namestringrequired

    Full name of the person or the institution.

  • emailstring

    Email address. Used later for portal invites and e-signature.

  • typestringdefault: individual

    A person or an entity.

    One ofindividualinstitution

  • relationshipstringdefault: employee

    How they relate to the company.

    One offounderemployeeformer_employeeinvestoradvisorconsultantboard_memberother

  • titlestring

    Job title.

  • startDatedate

    Start date, YYYY-MM-DD.

  • externalIdstring

    Your own id for this person, such as an HRIS employee id.

Response 201

The new stakeholder's id.

  • idstring

    The new stakeholder's id.

Example

Request
curl -X POST https://capable.so/api/v1/stakeholders \
  -H "Authorization: Bearer $CAPABLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jordan Lee",
    "email": "jordan@northwind.ai",
    "relationship": "employee",
    "title": "Product designer",
    "startDate": "2026-11-17",
    "externalId": "rippling-0187"
  }'
Response · 201 Created
JSON
{
  "id": "stk_b2j6nq0ve8rc"
}

Good to know

  • The new stakeholder is recorded in the company's activity log as created by the API, and a stakeholder.created webhook is sent.

Errors

StatusWhen
400 Bad requestThe body is not JSON.
401 UnauthorizedThe key is missing, invalid or revoked, or its creator lost access.
402 Payment requiredThe company has no active plan in good standing.
403 ForbiddenThe key does not have the stakeholders:write scope.
429 Too many requestsThe key went over its rate limit. Wait for Retry-After seconds.
422 UnprocessableA field is missing or invalid. The message names each field.

Every error has the same shape. See Errors, limits and conventions.