# POST /companies

**Resource:** [Companies](./companies.md)  
**Scopes:** `companies:write`  
**Write operation:** yes

Create a new company. name is required. Set skip_automations: true to suppress the customer_created trigger -- recommended for historical imports. Legacy alias: POST /customers.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `name` | body | string | yes | Company / organisation name |
| `email` | body | string | no | Primary email |
| `phone` | body | string | no | Mobile number in E.164 format (e.g. +61412345678). MUST be a mobile number -- landlines will be rejected with a 400 error. Use the landline field for fixed-line/office numbers. |
| `landline` | body | string | no | Landline / office phone number in E.164 format (e.g. +61299991234) |
| `industry` | body | string | no | Industry sector |
| `website` | body | string | no | Website URL |
| `notes` | body | string | no | Notes |
| `metadata` | body | object | no | Custom field values as { field_id: value } pairs. Use GET /crm-settings to discover available custom fields. Reserved key: "quick_links" stores per-company Quick Link URLs as { <type-uuid>: <url> } -- define types via PATCH /company/crm-settings. UUID-shaped keys at metadata root are rejected (400). |
| `skip_automations` | body | boolean | no | Set true to suppress the customer_created trigger. Use for historical imports. Default false. |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Corp", "email": "info@acme.com", "phone": "+61412345678", "landline": "+61290001234" }'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`