Authorizations
Path Parameters
The Ampersand project ID or project name.
Body
The ID of the user group that has access to this installation.
"group-123"
The consumer reference.
The provider name (e.g. "salesforce", "hubspot")
The ID of the provider workspace that this connection belongs to.
The name of the user group that has access to this installation.
The name of the consumer that has access to this installation.
The API key to use for the connection.
Values used for custom auth input variables.
{
"apiKey": "abcd1234",
"password": "secret"
}
Response
Created
The connection ID.
"connection-123"
The Ampersand project ID.
"project-456"
The SaaS provider that this Connection is for.
"salesforce"
The time the connection was created.
"2023-07-13T21:34:44.816Z"
The authentication scheme used for this connection.
none
, apiKey
, basic
, oauth2/authorizationCode
, oauth2/authorizationCodePKCE
, oauth2/clientCredentials
, oauth2/password
"oauth2/authorizationCode"
The status of the connection.
created
: The connection has just been created or the access token was just refreshed.working
: The connection has successfully been used to make a request.bad_credentials
: The connection encountered credential-related issues when making a request, or when attempting to refresh the access token.
created
, working
, bad_credentials
"working"
If available, the identifier for the provider workspace (e.g. the Salesforce subdomain)
"provider-workspace-123"
If available, the ID that Salesforce/Hubspot uses to identify this user (e.g. Salesforce has IDs in the form of https://login.salesforce.com/id/00D4x0000019CQTEA2/0054x000000orJ4AA)
"provider-consumer-123"
The time the connection was last updated.
"2023-07-13T21:34:44.816Z"
The API key used while making the connection.
"api-key-123"