> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a worker contact

> Add a contact to a worker.

### Parameters

<ParamField body="worker" type="string" required>
  ID of the worker this contact belongs to.
</ParamField>

<ParamField body="purpose" type="string" required>
  Contact purpose. Currently `emergency`.
</ParamField>

<ParamField body="name" type="object" required>
  The contact's name. Same shape as a worker's name (e.g. `first`, `last`,
  `full`, `display`).
</ParamField>

<ParamField body="relationship" type="string" required>
  Free-text relationship to the worker.
</ParamField>

<ParamField body="phones" type="array">
  Phone numbers for this contact. Each entry requires `type` and `value`, and
  may include `extension` and `primary`. Phone types are `mobile`, `home`,
  `work`, or `other`.
</ParamField>

<ParamField body="emails" type="array">
  Email addresses for this contact. Each entry requires `type` and `value`, and
  may include `primary`. Email types are `personal`, `work`, or `other`.
</ParamField>

<ParamField body="address" type="object">
  Optional mailing address for this contact.
</ParamField>

<ParamField body="priority" type="integer">
  Contact priority within the purpose. Required for emergency contacts.
</ParamField>

<ParamField body="status" type="string">
  Contact status. One of `active` or `inactive`. Defaults to `active`.
</ParamField>

### Returns

Returns the created [Worker contact object](/reference/worker-contacts/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "worker": "wrkr_8oWZpQ2rL4sk",
    "purpose": "emergency",
    "name": { "full": "Amara Okafor", "display": "Amara Okafor" },
    "relationship": "spouse",
    "phones": [{ "type": "mobile", "value": "+14155550123", "primary": true }],
    "emails": [{ "type": "personal", "value": "amara@example.com", "primary": true }],
    "priority": 1
  }
  ```

  ```json Response theme={null}
  {
    "id": "wcon_8oWZpQ2rL4sk",
    "object": "worker_contact",
    "worker": "wrkr_8oWZpQ2rL4sk",
    "purpose": "emergency",
    "name": { "full": "Amara Okafor", "display": "Amara Okafor" },
    "relationship": "spouse",
    "phones": [{ "type": "mobile", "value": "+14155550123", "extension": null, "primary": true }],
    "emails": [{ "type": "personal", "value": "amara@example.com", "primary": true }],
    "address": null,
    "priority": 1,
    "status": "active",
    "created": "2026-06-21T12:00:00Z",
    "updated": "2026-06-21T12:00:00Z"
  }
  ```
</ResponseExample>