# Create Phone Number

`lawmatics_create-phone-number` · Lawmatics MCP tool · Phone Numbers

Create a phone number and attach it to a contact, matter, or company in Lawmatics. Provide the phone number string, a label (e.g. Primary, Mobile), and the ID of exactly one entity (matter, contact, or company). Attaching to a matter sets the phone number on the matter's contact or company. Returns the created record with a `relationships` envelope carrying an {id,type} pointer to the owning record (contact, company, or firm).

## Input

- **phoneNumber** `string` (required) — The phone number string
- **phoneType** `string` (required) — Phone number label (e.g. Primary, Mobile, Work, Home)
- **matterId** `string` — ID of the matter to attach this phone number to
- **contactId** `string` — ID of the contact to attach this phone number to
- **companyId** `string` — ID of the company to attach this phone number to

## Output

- **id** `string` (required) — Unique ID of the phone number record
- **phoneType** `string` (required) — Phone number label (e.g. Primary, Mobile, Work, Home)
- **phoneNumber** `string` (required) — The phone number string, formatted as stored
- **relationships** `object` (required) — JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'contact' -> get-contact, type 'company' -> get-company).
  - **informationable** `object | null` (required) — Owning record pointer (contact, company, or firm); null when unset
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized