# List crm connection metadata

`GET` `/api/v1/crm-connections/{crm_connection_id}/metadata`

Return the field schema for the requested CRM object type: `account`
(Salesforce) or `company` (HubSpot). If `type` is omitted it defaults to
the appropriate type for the connection. Fields with `updateable: true` can
be written to; non-updateable fields (e.g. Salesforce `Id`, HubSpot
`hs_object_id`) are read-only.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | — |

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| type | string | no | Object type to retrieve metadata for: `account` (Salesforce only) or `company` (HubSpot only). Defaults to `account` for Salesforce connections and `company` for HubSpot connections. |
| enumerate | string | no | When true, include allowed values for picklist (Salesforce) and enumeration (HubSpot) fields in the `options` array. Defaults to false. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| label | string | Human-readable field name |
| value | string | CRM API field name |
| field_type | string | Field data type (e.g. string, picklist, reference, boolean) |
| updateable | boolean | Whether the field can be written to |
| options | array[object] | Allowed values for picklist fields |

## Errors

| Status | Description |
|--------|-------------|
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |