# Create an index with integrated embedding

With this type of index, you provide source text, and  Pinecone uses a [hosted embedding model](/guides/index-data-create-an-index#embedding-models)  to convert the text automatically during [upsert](/guides/database-2025-10-data-plane-upsert-records)  and [search](/guides/database-2025-10-data-plane-search-records).\
For guidance and examples, see [Create an index](/guides/index-data-create-an-index#integrated-embedding).

```shell curl theme={null}
PINECONE_API_KEY="YOUR_API_KEY"

curl https://api.pinecone.io/indexes/create-for-model \
  -H "Content-Type: application/json" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10" \
  -d '{
        "name": "integrated-dense-curl",
        "cloud": "aws",
        "region": "us-east-1",
        "embed": {
          "model": "llama-text-embed-v2",
          "metric": "cosine",
          "field_map": {
            "text": "chunk_text"
          },
          "write_parameters": {
            "input_type": "passage",
            "truncate": "END"
          },
          "read_parameters": {
            "input_type": "query",
            "truncate": "END"
          }
        }
      }'
```

```json curl theme={null}
{
  "id": "9dabb7cb-ec0a-4e2e-b79e-c7c997e592ce",
  "name": "integrated-dense-curl",
  "metric": "cosine",
  "dimension": 1024,
  "status": {
    "ready": false,
    "state": "Initializing"
  },
  "host": "integrated-dense-curl-govk0nt.svc.aped-4627-b74a.pinecone.io",
  "spec": {
    "serverless": {
      "region": "us-east-1",
      "cloud": "aws"
    }
  },
  "deletion_protection": "disabled",
  "tags": null,
  "embed": {
    "model": "llama-text-embed-v2",
    "field_map": {
      "text": "chunk_text"
    },
    "dimension": 1024,
    "metric": "cosine",
    "write_parameters": {
      "input_type": "passage",
      "truncate": "END"
    },
    "read_parameters": {
      "input_type": "query",
      "truncate": "END"
    }
  }
}
```

`POST /indexes/create-for-model`

:::code-group
```bash title="cURL"
curl --request POST \
  --url https://api.pinecone.io/indexes/create-for-model \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "example-index",
  "cloud": "aws",
  "region": "us-east-1",
  "deletion_protection": "<string>",
  "tags": {
    "tag0": "val0",
    "tag1": "val1"
  },
  "schema": {
    "fields": {
      "description": {
        "filterable": true
      },
      "genre": {
        "filterable": true
      },
      "year": {
        "filterable": true
      }
    }
  },
  "read_capacity": {
    "mode": "OnDemand"
  },
  "embed": {
    "field_map": {
      "text": "your-text-field"
    },
    "metric": "cosine",
    "model": "multilingual-e5-large",
    "read_parameters": {
      "input_type": "query",
      "truncate": "NONE"
    },
    "write_parameters": {
      "input_type": "passage"
    }
  }
}'
```

```json title="201"
{
  "name": "example-index",
  "dimension": 1536,
  "metric": "<string>",
  "host": "semantic-search-c01b5b5.svc.us-west1-gcp.pinecone.io",
  "private_host": "semantic-search-c01b5b5.svc.private.us-west1-gcp.pinecone.io",
  "deletion_protection": "<string>",
  "tags": {
    "tag0": "val0",
    "tag1": "val1"
  },
  "embed": {
    "field_map": {
      "text": "your-text-field"
    },
    "metric": "cosine",
    "model": "multilingual-e5-large",
    "read_parameters": {
      "input_type": "query",
      "truncate": "NONE"
    },
    "write_parameters": {
      "input_type": "passage"
    }
  },
  "spec": {
    "pod": {
      "environment": "us-east-1-aws",
      "metadata_config": {
        "indexed": [
          "genre",
          "title",
          "imdb_rating"
        ]
      },
      "pod_type": "p1.x1",
      "pods": 1,
      "replicas": 1,
      "shards": 1
    }
  },
  "status": {
    "ready": true,
    "state": "ScalingUpPodSize"
  },
  "vector_type": "<string>"
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Body

- `name` (body, string, required) — The name of the index. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or '-'.
- `cloud` (body, string, required) — The public cloud where you would like your index hosted. Possible values: `gcp`, `aws`, or `azure`.
- `region` (body, string, required) — The region where you would like your index to be created.
- `deletion_protection` (body, string) — Whether [deletion protection](/guides/manage-data-manage-indexes#configure-deletion-protection) is enabled/disabled for the index. Possible values: `disabled` or `enabled`.
- `tags` (body, object) — Custom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '_', or '-'. Values must be alphanumeric, ';', '@', '_', '-', '.', '+', or ' '. To unset a key, set the value to be an empty string.
- `schema` (body, object) — Schema for the behavior of Pinecone's internal metadata index. By default, all metadata is indexed; when `schema` is present, only fields which are present in the `fields` object with a `filterable: true` are indexed. Note that `filterable: false` is not currently supported.
- `read_capacity` (body, object) — By default the index will be created with read capacity mode `OnDemand`. If you prefer to allocate dedicated read nodes for your workload, you must specify mode `Dedicated` and additional configurations for `node_type` and `scaling`.
- `embed` (body, object, required) — Specify the integrated inference embedding configuration for the index. Once set the model cannot be changed, but you can later update the embedding configuration for an integrated inference index including field map, read parameters, or write parameters. Refer to the [model guide](/guides/index-data-create-an-index#embedding-models) for available models and model details.

## Response

- `201` — The index has successfully been created for the embedding model.
- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `404` — Unknown cloud or region when creating a serverless index.
- `409` — Index of given name already exists.
- `422` — Unprocessable entity. The request body could not be deserialized.
- `500` — Internal server error.

## Related pages

- [List indexes](./database-2026-07-control-plane-list-indexes.md)
- [Create an index](./database-2026-07-control-plane-create-index.md)
- [Create an index with integrated embedding](./database-2026-07-control-plane-create-for-model.md)
- [Describe an index](./database-2026-07-control-plane-describe-index.md)
- [Delete an index](./database-2026-07-control-plane-delete-index.md)
- [Configure an index](./database-2026-07-control-plane-configure-index.md)
- [Get index stats](./database-2026-07-data-plane-describeindexstats.md)
- [List indexes](./database-2026-04-control-plane-list-indexes.md)
- [Create an index](./database-2026-04-control-plane-create-index.md)
- [Create an index with integrated embedding](./database-2026-04-control-plane-create-for-model.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.