---
title: "POST /v1/Keys"
method: POST
path: "/v1/Keys"
tags: ["IamV1NewApiKey"]
---

# POST /v1/Keys

`POST /v1/Keys`

Create a new Signing Key for the account making the request.

## Response `201`

Created

- IamV1NewKey
  - `sid` string, nullable — The unique string that that we created to identify the NewKey resource. You will use this as the basic-auth `user` when authenticating to the API.
  - `friendly_name` string, nullable — The string that you assigned to describe the resource.
  - `date_created` string, date-time-rfc-2822, nullable — The date and time in GMT that the API Key was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time-rfc-2822, nullable — The date and time in GMT that the new API Key was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `secret` string, nullable — The secret your application uses to sign Access Tokens and to authenticate to the REST API (you will use this as the basic-auth `password`). **Note that for security reasons, this field is ONLY returned when the API Key is first created.**
  - `policy` object, nullable — Collection of allow assertions.

---

[API](https://skmtc.net/twilio/apis/iam-v1.md) · [All operations](https://skmtc.net/twilio/apis/iam-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/iam-v1/revisions/fea70127b4d0/schema)