# Invite a user to the organization **POST** `/admin/invites` :::code-group ```bash title="cURL" curl --request POST \ --url https://api.pinecone.io/admin/invites \ --header 'Authorization: Bearer ' \ --header 'X-Pinecone-Api-Version: ' \ --header 'Content-Type: application/json' \ --data '{ "email": "newhire@acme.com", "role_bindings": [ { "resource_type": "organization", "role": "OrgMember" } ] }' ``` ```python title="Python" import requests url = "https://api.pinecone.io/admin/invites" payload = { "email": "newhire@acme.com", "role_bindings": [ { "resource_type": "organization", "role": "OrgMember" } ] } headers = { "Authorization": "Bearer ", "X-Pinecone-Api-Version": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ```javascript title="JavaScript" const options = {method: "POST", headers: {"Authorization": "Bearer ", "X-Pinecone-Api-Version": "", "Content-Type": "application/json"}, body: JSON.stringify({ "email": "newhire@acme.com", "role_bindings": [ { "resource_type": "organization", "role": "OrgMember" } ] })}; fetch("https://api.pinecone.io/admin/invites", options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ```php title="PHP" "https://api.pinecone.io/admin/invites", CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "{\"email\":\"newhire@acme.com\",\"role_bindings\":[{\"resource_type\":\"organization\",\"role\":\"OrgMember\"}]}", CURLOPT_HTTPHEADER => [ "Authorization: Bearer ", "X-Pinecone-Api-Version: ", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ```go title="Go" package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.pinecone.io/admin/invites" payload := strings.NewReader("{\"email\":\"newhire@acme.com\",\"role_bindings\":[{\"resource_type\":\"organization\",\"role\":\"OrgMember\"}]}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("X-Pinecone-Api-Version", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ```java title="Java" HttpResponse response = Unirest.post("https://api.pinecone.io/admin/invites") .header("Authorization", "Bearer ") .header("X-Pinecone-Api-Version", "") .header("Content-Type", "application/json") .body("{\"email\":\"newhire@acme.com\",\"role_bindings\":[{\"resource_type\":\"organization\",\"role\":\"OrgMember\"}]}") .asString(); ``` ```ruby title="Ruby" require 'uri' require 'net/http' url = URI("https://api.pinecone.io/admin/invites") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["X-Pinecone-Api-Version"] = '' request["Content-Type"] = 'application/json' request.body = "{\"email\":\"newhire@acme.com\",\"role_bindings\":[{\"resource_type\":\"organization\",\"role\":\"OrgMember\"}]}" response = http.request(request) puts response.read_body ``` ::: :::code-group ```json title="200" { "created_at": "2026-04-14T20:00:00.000Z", "email": "newhire@acme.com", "expires_at": "2026-05-21T03:00:00.000Z", "id": "9c8e3528-b9c0-4358-84ce-84c28e91b566", "processed_at": null, "status": "pending" } ``` ```json title="400" { "error": { "code": "INVALID_ARGUMENT", "message": "Bad request. The request body included invalid request parameters." }, "status": 400 } ``` ```json title="401" { "error": { "code": "UNAUTHENTICATED", "message": "Invalid API key." }, "status": 401 } ``` ```json title="403" { "error": { "code": "QUOTA_EXCEEDED", "message": "The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota." }, "status": 429 } ``` ```json title="409" { "error": { "code": "ABORTED", "message": "Cannot delete the last OrgOwner role binding for this organization." }, "status": 409 } ``` ```json title="500" { "error": { "code": "UNKNOWN", "message": "Internal server error" }, "status": 500 } ``` ```json title="4XX" { "error": { "code": "QUOTA_EXCEEDED", "message": "The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota." }, "status": 429 } ``` ::: #### Authorizations | Prop | Type | Default | Description | | --- | --- | --- | --- | | `Authorization` | `string` | - | | An [access token](/guides/admin-organizations-manage-service-accounts#retrieve-an-access-token) must be provided in the `Authorization` header using the `Bearer` scheme. #### Headers | Prop | Type | Default | Description | | --- | --- | --- | --- | | `X-Pinecone-Api-Version` | `string` | `2026-07` | Required date-based version header | #### Body The invite to create. | Prop | Type | Default | Description | | --- | --- | --- | --- | | `email` | `string` | - | The email address to invite. Required string length: 0 - 254. Example: newhire@acme.com | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `role_bindings` | `object[]` | - | Role bindings for the invitee. Must include at least one organization-scoped binding that grants organization membership (OrgOwner, OrgManager, OrgBillingAdmin, or OrgMember); project-scoped bindings are optional. Not returned in the response. | :::accordion{title="Show child attributes"} | Prop | Type | Default | Description | | --- | --- | --- | --- | | `resource_type` | `string` | - | The kind of resource scope a role binding applies to. Possible values: organization, project. Example: project | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `resource_id?` | `string` | - | Project UUID. Required when resource_type is project; omit for organization scope. | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `role` | `string` | - | A role assigned to a principal at a resource scope. Example: ProjectOwner | ::: #### Response `200` — Invite created and email sent. The invite's role bindings are first-class; view or change them through the role-binding endpoints. An invitation to join the organization. | Prop | Type | Default | Description | | --- | --- | --- | --- | | `id` | `string` | - | The unique ID of the invite. | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `email` | `string` | - | The email address the invite was sent to. | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `status` | `string` | - | The lifecycle status of an invite. Possible values: pending, expired, processed. List endpoints return only pending and expired invites; processed is returned only when fetching a single invite by ID. Example: pending | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `expires_at?` | `string \| null` | - | When the invite expires if not accepted. Default TTL is 7 days. Resending the invite extends this to now plus 7 days. null if the invite does not expire. | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `processed_at?` | `string \| null` | - | The date and time the invite was accepted. null or omitted while the invite is still pending or expired. | | Prop | Type | Default | Description | | --- | --- | --- | --- | | `created_at` | `string` | - | The date and time the invite was created. | ## Related pages - [List invites](./admin-2-invites-list-invites.md) - [Get invite details](./admin-2-invites-get-invite-details.md) - [Delete an invite](./admin-2-invites-delete-an-invite.md) - [Resend an invite email](./admin-2-invites-resend-an-invite-email.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.