Attribute usage to your integration

After you create your integration, specify a source tag when you create a client with a Pinecone SDK. If you call the API directly, pass the source tag in the User-Agent header.

Anyone can create an integration. To apply to become an official Pinecone partner, see Integration ecosystem.

Source tag naming conventions

Your source tag must follow these conventions:

Clearly identify your integration.
Use only lowercase letters, numbers, underscores, and colons.

For example, for an integration called “New Framework”, "new_framework" is valid, but "new framework" and "New_framework" aren’t.

Specify a source tag

Source tags require these minimum SDK versions:

Pinecone SDK	Required version
Python	v3.2.1+
Node.js	v2.2.0+
Java	v1.0.0+
Go	v0.4.1+

Pass the source tag when you create the client, or in the User-Agent header with curl:

# REST client
from pinecone import Pinecone

pc = Pinecone(
    api_key="YOUR_API_KEY", 
    source_tag="YOUR_SOURCE_TAG"
)

# gRPC client
from pinecone.grpc import PineconeGRPC

pc = PineconeGRPC(
    api_key="YOUR_API_KEY", 
    source_tag="YOUR_SOURCE_TAG"
)

import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ 
    apiKey: 'YOUR_API_KEY', 
    sourceTag: 'YOUR_SOURCE_TAG' 
});

import io.pinecone.clients.Pinecone;

public class IntegrationExample {
    public static void main(String[] args) {
        Pinecone pc = new Pinecone.Builder("YOUR_API_KEY")
                .withSourceTag("YOUR_SOURCE_TAG")
                .build();
    }
}

import "github.com/pinecone-io/go-pinecone/v4/pinecone"

client, err := pinecone.NewClient(pinecone.NewClientParams{
	ApiKey: "YOUR_API_KEY",
	SourceTag: "YOUR_SOURCE_TAG",
})

curl -i -X GET "https://api.pinecone.io/indexes" \
  -H "Accept: application/json" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "User-Agent: source_tag=YOUR_SOURCE_TAG" \
  -H "X-Pinecone-Api-Version: 2026-07"

Connect an integration

Build an integration

Attribute usage to your integration

Source tag naming conventions

Specify a source tag

​Source tag naming conventions

​Specify a source tag

Source tag naming conventions

Specify a source tag