---
title: "Create API credentials"
method: POST
path: "/v2/credentials"
tags: ["Credentials"]
---

# Create API credentials

`POST /v2/credentials`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/credentials`
- Auth: HTTP bearer

Create API client credentials for a given user. To make this request, your API client credentials must be associated with a Sigma admin user for the same Sigma organization.

  **Important:** The response includes sensitive information. Ensure that you securely store and handle the returned `clientId` and `clientSecret`. These credentials grant access to your Sigma account and should never be exposed publicly or shared unnecessarily.

  ### Usage Notes:
  - Retrieve the **ownerId** by calling the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint and using the `memberId` included in the response.

## Request body

- object
  - `ownerId` string, required: Unique identifier of the user.
  - `name` string, required: Name of the credentials.
  - `description` string: Description of the credentials
  - `scopes` V2CredentialsPostRequestBodyContentApplicationJsonSchemaScopesItems[]: Scopes to assign to the credentials. If not provided, defaults to "api".

## Response `200`

The response body.

- CredentialsCreateCredentialsResponse200
  - `clientId` string, required
  - `clientSecret` string, required

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)
