Skip to navigation
Management APIAPI Keys

Create API key

Creates a new API key and secret to use in the Authorization and X-Signature headers for requests to the Cash App Pay API. This key will automatically expire at the date and time specified in the expires_at field in the response payload.

Note

The secret returned in the response payload is what you use to calculate the X-Signature header. The API key ID is only used to keep track of which API keys are active, and isn’t considered secret. Keep in mind that the secret can never be retrieved in subsequent requests to the API, so make sure to store it immediately!

This endpoint is rate limited to 5 QPS.

Scopes: API_KEYS_WRITE

Headers

AcceptstringRequired
X-RegionstringRequired
X-SignaturestringRequired
User-AgentstringRequired

Request

This endpoint expects an object.
idempotency_keystringRequired1-64 characters

A unique identifier which can be used by Cash App to de-duplicate retries of this request, making it idempotent. Learn more about idempotency in the API.

api_keyobjectRequired
Details about the API key to create.

Response

Created
api_keyobject
secretstring32-256 characters

Secret value to use when calculating the X-Signature header of requests.

This value is not returned when retrieving an API key, so make sure to store it immediately.

Min length: 32 Max length: 256

Errors

400
Bad Request Error