# Create market map

`POST` `/api/v1/market-maps`

Accept configuration JSON and start an asynchronous market map creation.
Returns the new market map ID with PENDING status. Poll run status via the
runs endpoints.

Credit/subscription validation happens server-side before accepting the request.

## Request body

`application/json`

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| source | object | yes | Data source to create the market map from |
| source.type | string | yes | Source type. Currently only 'csv' is supported. |
| source.id | string | yes | asset://<uuid> URI for the data source (see Assets endpoint). |
| fields | object | yes | Field mappings for the source data |
| fields.id | string | yes | Column name for account ID |
| fields.name | string | yes | Column name for account name |
| fields.url | string | no | Column name for account website URL |
| fields.target | object | yes | Target criteria: the field and values that identify reference accounts |
| fields.target.field | string | yes | Column name used for target criteria |
| fields.target.values | array[string] | yes | Picklist values that identify reference accounts |
| fields.target_weight | string | no | Column name for prioritization weight |
| discover_urls | boolean | no | Auto-discover website URLs for accounts missing a url mapping |
| icp | string | no | Free-text Ideal Customer Profile description |

## Response

`201 Created` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | UUID of the newly created market map |
| status | string | Initial status (PENDING) |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 402 | Payment Required |
| 403 | Forbidden |
| 422 | Unprocessable Entity |