Destinations
Ampersand currently supports webhook destinations. When new data is read from a SaaS instance via a Read Action, a webhook message will be sent to you. See Example webhook message for what the payload will look like.
Add a destination to the Ampersand Dashboard
Go to the Destinations page of Ampersand Dashboard to add a new Destination. You’ll need:
- Destination name: this is an alias for the webhook that you can then refer to in the
amp.yaml
file. - URL: this is the URL of your webhook, it must start with
https
. If you do not have a webhook already, you can easily create a temporary one using tools like Hookdeck Console.
Refer to the destination in your integration
For read and subscribe actions, you can specify destinations for each object. You can either have one destination for each object or route multiple objects to the same destination. Here’s what your amp.yaml
file might look like if you had created 2 destinations in the Ampersand Dashboard, one named accountWebhook
and one named contactWebhook
.
YAML
specVersion: 1.0.0
integrations:
- name: readFromSalesforce
displayName: Salesforce read
provider: salesforce
read:
objects:
- objectName: account
destination: accountWebhook
- objectName: contact
destination: contactWebhook
Other Destinations
We have many other destination types on the roadmap, including:
- Postgres
- Ampersand-hosted Postgres
- Amazon S3
- Google Cloud Storage