Proxy Actions

A proxy action allows you to make passthrough API calls to the SaaS provider's API. To define a proxy action, add proxy as a key in your integration defined in amp.yaml:

      enabled: true

Make API calls

All proxy actions expose an API with the base of When making a passthrough call, simply replace the base URL with the Ampersand proxy URL. For example, instead of making a request to, making the same request to To see a list of all the API base URLs we proxy to, see the providers.yaml file in our connectors library.

Keep the request body and HTTP verb the same, and add these additional headers so Ampersand knows how to deliver the API request:

  • x-amp-proxy-version: this should always be 1
  • x-amp-project-id: your Ampersand project ID
  • x-api-key: your Ampersand API key

In order for Ampersand to know which SaaS instance to make the API call against, you'll need to provide either:

  • x-amp-installation-id: the installation ID, you'll get this from the CreateInstallation or ImportInstallation API endpoints, or the InstallIntegration React component.
  • or both of the following:
    • x-amp-integration-name: the integration name that you wrote in the amp.yaml file
    • x-amp-group-ref: the ID for the user group that you used in the OAuthConnect or ImportInstallation API endpoints; or the InstallIntegration React component.

Here is an example API call:

curl --location --request PUT '' \
--header 'Content-Type: application/json' \ # Other content types are supported
--header 'x-amp-project-id: my-ampersand-project-id' \
--header 'x-api-key: my-api-key' \
--header 'x-amp-proxy-version: 1' \
--header 'x-amp-integration-name: my-salesforce-integration' \
--header 'x-amp-group-ref: company-id-from-my-app' \
--data '{
    # Same request body as if you are sending the request to Salesforce