Create a secret

POST 
/integration_secrets

Create a new secret with an associated identifier that can be used to securely integrate with other services.

application/json

Body

required

identifier Identifier (string)required

The unique identifier of the secret.

value Value (string)required

The value of the secret.

201: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object

required

record_type Record Type (string)required

id Id (string)required

identifier Identifier (string)required

created_at date-timerequired

updated_at date-time

{
  "data": {
    "record_type": "integration_secret",
    "id": "string",
    "identifier": "string",
    "created_at": "2024-07-29T15:51:28.071Z",
    "updated_at": "2024-07-29T15:51:28.071Z"
  }
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

errors

object[]

Array [

code Telnyx error code (string)

detail Error details (string)required

title Error title (string)

]

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/integration_secrets' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "identifier": "my_secret",
  "value": "my_secret_value"
}'

Response samples

• 201
• 422

---

{
  "data": {
    "record_type": "integration_secret",
    "id": "string",
    "identifier": "string",
    "created_at": "2024-07-29T15:51:28.071Z",
    "updated_at": "2024-07-29T15:51:28.071Z"
  }
}

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}