Ampersand

API Reference

Start building now

Sign in

Hydrate a revision with information from the consumer's SaaS instance.

Hydrate a revision

APIKeyHeader

A Problem Details object (RFC 9457).

Additional properties specific to the problem type may be present.


Overview

Quickstart

Concepts

Read Actions

Write Actions

Proxy Actions

Subscribe actions

Embed UI components

Webhook destinations

Terminology

Acuity Scheduling

Aha!

Aircall

Airtable

Anthropic

Apollo

Asana

Ashby

Atlassian

Attio

AWeber

Bird (MessageBird)

Blueshift

Blueshift (EU)

Brevo

Bynder

Calendly

Campaign Monitor

Capsule

ChartMogul

Clari

ClickUp

Close

Constant Contact

Copper

Crunchbase

Customer.io Journeys App

Customer.io Journeys Track

Delighted

Discord

Dixa

Docusign

Drift

Dropbox

Dropbox Sign

Dynamics 365 Business Central

Dynamics 365 CRM

Facebook

Figma

Formstack

Front

Geckoboard

GetResponse

Gong

Google

Gorgias

Guru

Help Scout Mailbox

Hive

HubSpot

Insightly

Instantly

Intercom

Ironclad

Iterable

Jira

Jotform

Keap

Klaviyo

LinkedIn

Lemlist

Mailgun

Marketo

Microsoft

Miro

Mixmax

Monday

Mural

Notion

Nutshell

OpenAI

Outreach

Paddle

Paddle Sandbox

Pinterest

Pipedrive

Pipeliner

Podium

Rebilly

Recurly

Salesforce

Salesloft

Seismic

SendGrid

ServiceNow

Smartlead

Smartsheet

Snapchat Ads

Survey Monkey

Teamleader

Teamwork

Timely

Webflow

WordPress

Wrike

Zendesk Support

Dev and prod environments

Access via API key

Create, update, upsert or delete records

Generate a signed URL to upload write data to.

If a read action has delivery mode set to onRequest, then use this endpoint to request for more results. Learn more in [Delivery modes](https://docs.withampersand.com/define-integrations/read-actions#delivery-modes).

Deliver results

Generate a URL for the browser to render to kick off OAuth flow.

Get URL for OAuth flow

List all projects that the API key or user credential has access to

Create a new project

Get a project

Delete a project

Update a project

List provider apps

Create a new provider app

Delete a provider app

Update a provider app

List integrations

Create a new integration

Delete an integration

Batch upsert a group of integrations

Create a new revision

List installations

Create a new installation

Import an existing installation

Get an installation

Delete an installation

Update an installation

List operations

Get an operation

List logs for an operation

List providers

Get provider

List API keys

Create a new API key

Get an API key

Delete an API key

Update an API key

List connections

For providers which support OAuth2 Authorization Code, it is recommended that you use the [/oauth-connect endpoint](https://docs.withampersand.com/reference/oauth/get-url-for-oauth-flow) instead, unless you already have the refresh token and are importing it into Ampersand.

Generate a new connection

Get a connection

Delete a connection

Create a new group

Create a new consumer

List destinations

Create a new destination

Get a destination

Delete a destination

Update a destination

Generate a signed URL to upload a zip file to.

Create a new organization

Get an organization

Update an organization

List builders for an organization

List invites for an organization

Invite a user to an organization

Get an invite

Revoke an invite

Get information about the current user

Accept an invite

Get the billing account for an organization

Create a portal session for a billing account

Authentication

WRITE API

READ API

PLATFORM API

Hydrate a revision

Authorizations

Path Parameters

Query Parameters

Response