Skip to main content
POST
/
api
/
v1
/
app-connections
/
heroku
cURL
curl --request POST \
  --url https://us.infisical.com/api/v1/app-connections/heroku \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentials": {
    "authToken": "<string>"
  },
  "name": "<string>",
  "description": "<string>",
  "projectId": "<string>",
  "gatewayId": "<unknown>",
  "rotation": "<unknown>"
}
'
{
  "appConnection": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "credentials": {},
    "description": "<string>",
    "version": 1,
    "isPlatformManagedCredentials": false,
    "gatewayId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "projectId": "<string>",
    "isAutoRotationEnabled": false,
    "rotation": {
      "rotationInterval": 123,
      "rotateAtUtc": {
        "hours": 123,
        "minutes": 123
      },
      "lastRotationMessage": "<string>",
      "nextRotationAt": "2023-11-07T05:31:56Z"
    },
    "credentialsHash": "<string>",
    "project": {
      "name": "<string>",
      "id": "<string>",
      "type": "<string>",
      "slug": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://infisical-docs-self-host-infra.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Heroku OAuth Connections must be created through the Infisical UI. Check out the configuration docs for Heroku OAuth Connections for a step-by-step guide.

Body

application/json
​
method
enum<string>
required

The method used to authenticate with Heroku.

Available options:
auth-token
​
credentials
object
required

The credentials used to connect with Heroku.

​
name
string
required

The name of the Heroku Connection to create. Must be slug-friendly.

Required string length: 1 - 64
​
description
string | null

An optional description for the Heroku Connection.

Maximum string length: 256
​
projectId
string

The ID of the project to create the Heroku Connection in.

​
isPlatformManagedCredentials
enum<boolean>

Not supported for Heroku Connections.

Available options:
false
​
gatewayId

Not supported for Heroku Connections.

​
isAutoRotationEnabled
enum<boolean>

Not supported for Heroku Connections.

Available options:
false
​
rotation

Not supported for Heroku Connections.

Response

Default Response

​
appConnection
Heroku (Auth Token) · object
required