Skip to main content
POST
/
integrations
/
custom_provider
Create custom provider integration
curl --request POST \
  --url https://api.vantage.sh/v2/integrations/custom_provider \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "token": "accss_crdntl_35665ec3deb12451",
  "provider": "custom_provider",
  "account_identifier": "Custom Provider Integration",
  "status": "imported",
  "last_updated": null,
  "workspace_tokens": [],
  "created_at": "2024-08-27T22:22:24Z"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Create a Custom Provider Integration

​
name
string
required

Name of the Custom Provider Integration.

​
description
string

Description of the Custom Provider Integration.

Response

Integration model

​
token
string
​
provider
string

The name of the Integration.

Example:

"AWS"

​
account_identifier
string

The account identifier. For GCP this is the billing Account ID, for Azure this is the account ID

Example:

"011389-EF4C3E-3ED7AE"

​
status
enum<string>

The status of the Integration. Can be 'connected', 'error', 'pending', 'importing', 'imported', or 'disconnected'.

Available options:
connected,
error,
pending,
importing,
imported,
disconnected
Example:

"imported"

​
last_updated
string

The date and time, in UTC, when the Integration was last updated. ISO 8601 Formatted.

Example:

"2023-08-04T00:00:00Z"

​
workspace_tokens
string[]

The tokens for any Workspaces that the account belongs to.

​
created_at
string

The date and time, in UTC, the Integration was created. ISO 8601 Formatted.

Example:

"2023-08-04T00:00:00Z"