// Requires Node.js SDK v8.2.0 or later
import { AdminClient } from '@pinecone-database/pinecone';
// Reads PINECONE_CLIENT_ID and PINECONE_CLIENT_SECRET from the environment
const admin = new AdminClient();
// `clientSecret` is returned only once and cannot be retrieved later
const { serviceAccount, clientSecret } = await admin.serviceAccounts.create({
name: 'ci-prod',
roleBindings: [
{
resourceType: 'project',
resourceId: 'a2f7dddb-1597-4eff-9f71-535fde243f58',
role: 'DataPlaneEditor',
},
],
});
console.log(serviceAccount);
// Requires Go SDK v6.0.0 or later
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v6/pinecone"
)
func main() {
ctx := context.Background()
adminClient, err := pinecone.NewAdminClientWithContext(ctx, pinecone.NewAdminClientParams{
ClientId: os.Getenv("PINECONE_CLIENT_ID"),
ClientSecret: os.Getenv("PINECONE_CLIENT_SECRET"),
})
if err != nil {
log.Fatalf("Failed to create AdminClient: %v", err)
}
projectId := "a2f7dddb-1597-4eff-9f71-535fde243f58"
sa, err := adminClient.ServiceAccount.Create(ctx, &pinecone.CreateServiceAccountParams{
Name: "ci-prod",
RoleBindings: []pinecone.RoleBindingInput{
{
ResourceType: pinecone.ResourceTypeProject,
ResourceId: &projectId,
Role: "DataPlaneEditor",
},
},
})
if err != nil {
log.Fatalf("Failed to create service account: %v", err)
}
// ClientSecret is returned only once — store it securely and never log it
fmt.Printf("Successfully created service account: %v\n", sa.ServiceAccount.Id)
}
# Requires Terraform provider v4.0.0 or later
# Roles are assigned with separate pinecone_role_binding resources
resource "pinecone_service_account" "ci_prod" {
name = "ci-prod"
}
resource "pinecone_role_binding" "ci_prod_data_plane_editor" {
principal_id = pinecone_service_account.ci_prod.id
principal_type = "service_account"
resource_type = "project"
resource_id = "a2f7dddb-1597-4eff-9f71-535fde243f58"
role = "DataPlaneEditor"
}
output "ci_prod_client_secret" {
value = pinecone_service_account.ci_prod.client_secret
sensitive = true
}
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
curl "https://api.pinecone.io/admin/service-accounts" \
-H "X-Pinecone-Api-Version: 2026-04" \
-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
-d '{
"name": "ci-prod",
"role_bindings": [
{
"resource_type": "project",
"resource_id": "a2f7dddb-1597-4eff-9f71-535fde243f58",
"role": "DataPlaneEditor"
}
]
}'
{
"service_account": {
"id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"name": "ci-prod",
"client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
"created_at": "2026-04-10T15:23:00Z",
"updated_at": "2026-04-10T15:23:00Z"
},
"client_secret": "8p-kkC23XOWvkCosKq-BOn3G74qp__rBcDMxc82iB4gfzRvuhSCRBKM7C5Q7TAzj"
}
Create a service account
Create a service account with optional initial role bindings; the client secret is returned only once.
// Requires Node.js SDK v8.2.0 or later
import { AdminClient } from '@pinecone-database/pinecone';
// Reads PINECONE_CLIENT_ID and PINECONE_CLIENT_SECRET from the environment
const admin = new AdminClient();
// `clientSecret` is returned only once and cannot be retrieved later
const { serviceAccount, clientSecret } = await admin.serviceAccounts.create({
name: 'ci-prod',
roleBindings: [
{
resourceType: 'project',
resourceId: 'a2f7dddb-1597-4eff-9f71-535fde243f58',
role: 'DataPlaneEditor',
},
],
});
console.log(serviceAccount);
// Requires Go SDK v6.0.0 or later
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v6/pinecone"
)
func main() {
ctx := context.Background()
adminClient, err := pinecone.NewAdminClientWithContext(ctx, pinecone.NewAdminClientParams{
ClientId: os.Getenv("PINECONE_CLIENT_ID"),
ClientSecret: os.Getenv("PINECONE_CLIENT_SECRET"),
})
if err != nil {
log.Fatalf("Failed to create AdminClient: %v", err)
}
projectId := "a2f7dddb-1597-4eff-9f71-535fde243f58"
sa, err := adminClient.ServiceAccount.Create(ctx, &pinecone.CreateServiceAccountParams{
Name: "ci-prod",
RoleBindings: []pinecone.RoleBindingInput{
{
ResourceType: pinecone.ResourceTypeProject,
ResourceId: &projectId,
Role: "DataPlaneEditor",
},
},
})
if err != nil {
log.Fatalf("Failed to create service account: %v", err)
}
// ClientSecret is returned only once — store it securely and never log it
fmt.Printf("Successfully created service account: %v\n", sa.ServiceAccount.Id)
}
# Requires Terraform provider v4.0.0 or later
# Roles are assigned with separate pinecone_role_binding resources
resource "pinecone_service_account" "ci_prod" {
name = "ci-prod"
}
resource "pinecone_role_binding" "ci_prod_data_plane_editor" {
principal_id = pinecone_service_account.ci_prod.id
principal_type = "service_account"
resource_type = "project"
resource_id = "a2f7dddb-1597-4eff-9f71-535fde243f58"
role = "DataPlaneEditor"
}
output "ci_prod_client_secret" {
value = pinecone_service_account.ci_prod.client_secret
sensitive = true
}
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
curl "https://api.pinecone.io/admin/service-accounts" \
-H "X-Pinecone-Api-Version: 2026-04" \
-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
-d '{
"name": "ci-prod",
"role_bindings": [
{
"resource_type": "project",
"resource_id": "a2f7dddb-1597-4eff-9f71-535fde243f58",
"role": "DataPlaneEditor"
}
]
}'
{
"service_account": {
"id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"name": "ci-prod",
"client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
"created_at": "2026-04-10T15:23:00Z",
"updated_at": "2026-04-10T15:23:00Z"
},
"client_secret": "8p-kkC23XOWvkCosKq-BOn3G74qp__rBcDMxc82iB4gfzRvuhSCRBKM7C5Q7TAzj"
}
// Requires Node.js SDK v8.2.0 or later
import { AdminClient } from '@pinecone-database/pinecone';
// Reads PINECONE_CLIENT_ID and PINECONE_CLIENT_SECRET from the environment
const admin = new AdminClient();
// `clientSecret` is returned only once and cannot be retrieved later
const { serviceAccount, clientSecret } = await admin.serviceAccounts.create({
name: 'ci-prod',
roleBindings: [
{
resourceType: 'project',
resourceId: 'a2f7dddb-1597-4eff-9f71-535fde243f58',
role: 'DataPlaneEditor',
},
],
});
console.log(serviceAccount);
// Requires Go SDK v6.0.0 or later
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v6/pinecone"
)
func main() {
ctx := context.Background()
adminClient, err := pinecone.NewAdminClientWithContext(ctx, pinecone.NewAdminClientParams{
ClientId: os.Getenv("PINECONE_CLIENT_ID"),
ClientSecret: os.Getenv("PINECONE_CLIENT_SECRET"),
})
if err != nil {
log.Fatalf("Failed to create AdminClient: %v", err)
}
projectId := "a2f7dddb-1597-4eff-9f71-535fde243f58"
sa, err := adminClient.ServiceAccount.Create(ctx, &pinecone.CreateServiceAccountParams{
Name: "ci-prod",
RoleBindings: []pinecone.RoleBindingInput{
{
ResourceType: pinecone.ResourceTypeProject,
ResourceId: &projectId,
Role: "DataPlaneEditor",
},
},
})
if err != nil {
log.Fatalf("Failed to create service account: %v", err)
}
// ClientSecret is returned only once — store it securely and never log it
fmt.Printf("Successfully created service account: %v\n", sa.ServiceAccount.Id)
}
# Requires Terraform provider v4.0.0 or later
# Roles are assigned with separate pinecone_role_binding resources
resource "pinecone_service_account" "ci_prod" {
name = "ci-prod"
}
resource "pinecone_role_binding" "ci_prod_data_plane_editor" {
principal_id = pinecone_service_account.ci_prod.id
principal_type = "service_account"
resource_type = "project"
resource_id = "a2f7dddb-1597-4eff-9f71-535fde243f58"
role = "DataPlaneEditor"
}
output "ci_prod_client_secret" {
value = pinecone_service_account.ci_prod.client_secret
sensitive = true
}
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
curl "https://api.pinecone.io/admin/service-accounts" \
-H "X-Pinecone-Api-Version: 2026-04" \
-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
-d '{
"name": "ci-prod",
"role_bindings": [
{
"resource_type": "project",
"resource_id": "a2f7dddb-1597-4eff-9f71-535fde243f58",
"role": "DataPlaneEditor"
}
]
}'
{
"service_account": {
"id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"name": "ci-prod",
"client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
"created_at": "2026-04-10T15:23:00Z",
"updated_at": "2026-04-10T15:23:00Z"
},
"client_secret": "8p-kkC23XOWvkCosKq-BOn3G74qp__rBcDMxc82iB4gfzRvuhSCRBKM7C5Q7TAzj"
}
Authorizations
An access token must be provided in the Authorization header using the Bearer scheme.
Headers
Required date-based version header
Body
The service account to create. Repeating this request may create duplicate service accounts.
The human-readable name of the service account.
1 - 80"ci-prod"
Optional initial role bindings. Omitting the field or passing an empty array creates the service account with no role bindings; roles can be added later via the role binding endpoints. A service account may be granted any organization- or project-scoped role. Not returned in the response.
100Show child attributes
Show child attributes
Response
Service account created. Role bindings are not returned here; use GET /admin/role-bindings to list them.
A service account with a newly issued OAuth client_secret. The secret is returned only once and cannot be retrieved later.
A service account. The OAuth client_secret is not included.
Show child attributes
Show child attributes
{
"client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
"created_at": "2026-04-10T15:23:00.000Z",
"id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"name": "My Service Account",
"updated_at": "2026-04-12T09:11:00.000Z"
}
The OAuth client secret. Returned exactly once. Treat this value as a credential — store it securely and never log it.
Was this page helpful?