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
, 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"