An OAuth 2.0 connection is a saved sign-in to another service (you approve access once, and Tape then signs requests for you without storing your password in the automation). Connections are meant to help you call services that don't accept a plain request, such as a calendar or a customer database.
You can use connections for many things, including:
Creating an event in a calendar when a showing is booked.
Updating a contact in another customer system when a lead changes.
Note:
A connection is saved for your whole organization. You can choose the same connection in any
Send API requestaction.Without a connection, Tape skips the step. The step doesn't fail, but no request is sent.
Only public services can be reached. Tape blocks requests to private or internal addresses.
Who can use connections?
Automations are available on all plans: Free, Plus, and Premium. The number of automation actions per month depends on your plan. See the limits for your plan on our pricing page.
Only organization admins can add, verify, edit, or delete OAuth 2.0 connections, and choose a connection in
Send API request.A connection is shared across your organization, so any automation can use it once an organization admin has set it up.
Add the Send API request action
To call a service with a connection:
Open the app and click the automations icon at the top right (
Create and view automations).Open an automation, or select
New automationand choose a trigger.Select
Add action→Send API request.Select the method (
GET,POST,PUT,PATCH, orDELETE), then enter theURL.Open
Choose a connectionand select a connection, or selectAdd connectionto set up a new one.Add the data you send in
Request. SelectShow headers→Add headerfor headers.Select
Save changes.
The answer is saved in a variable called API response. Use it in later actions with @. Learn more about record values and variables →
Set up a connection
Any service that supports OAuth 2.0 works. To set up a connection:
In
Send API request, openChoose a connectionand selectAdd connection.Enter a
Connection name.Enter the
Client ID,Client secret,Authorize URL, andToken URLfrom the service's API documentation.Add
Scopes (optional)andResource owner details URL (optional)if the service needs them. Without a resource owner details URL, you can't verify the connection later.Select
Save connectionand approve access at the service.
Each connection in the list shows Active or Broken. Select ••• next to a connection to Verify, Reauthorize, Edit, or Delete it. Verify is only available if the connection has a Resource owner details URL (optional).
Send API request settings
Connection: the sign-in that Tape uses to sign the request.Method:
GET,POST,PUT,PATCH, orDELETE.URL: the address of the service. You can add record values with@.Request: the body of the request. It's empty if you leave it out.Show headers: opens a list of headers. SelectAdd headerand fill inHeaderandValue. SelectHide headersto close the list.Action menu:
Follow redirectsfollows 3xx answers (off by default), andContinue on errorlets the run go on if the request fails.
Let's look at an example
Let's say your sales team keeps contacts in a customer system that uses OAuth 2.0. Here's how to add a note when a lead is won:
Set the trigger to
When a record is updatedand add a filter so the automation only runs whenStatusisWon.Select
Add action→Send API requestand choosePOST.Enter the address of the notes endpoint of your customer system in
URL.Select your connection under
Connection.In
Request, enter the note and insert the lead's name with@.Select
Save changes.
When a lead is won, the note appears in the customer system.
OAuth 2.0 connection errors
The connection expired or was removed. The service no longer accepts the saved sign-in, and requests fail. A connection that no longer works shows
Broken. OpenChoose a connection, select•••next to it, thenReauthorize.The request is rejected with a permission error. The connection may not have the permission the service needs. Select
•••next to the connection, thenEdit, change theScopes (optional), and selectSave connection. Then reauthorize the connection.The request never leaves Tape. The address may point to a private network. Tape only calls public services.
The service blocks the request. Add the IP addresses of Tape to the allowed list of the service. Learn more about IP addresses →
Test, pause, or edit a connection
Use
Manual runto send a real request once, to check the setup.To change the connection of an action, open the automation, select the
Send API requeststep, choose another connection, then selectSave changes.To remove a connection, open
Choose a connection, select•••next to it, thenDelete. Automations that use it becomeBroken.
Learn more
FAQs
What's the difference between Send HTTP request and Send API request?
What's the difference between Send HTTP request and Send API request?
Send HTTP request sends exactly what you enter. Send API request also signs the request with a connection, so you use it for services that need OAuth 2.0.
Can I use one connection in several automations?
Can I use one connection in several automations?
Yes! Connections are shared across your organization, so you can use one connection in many automations.
Can I create a connection with the API?
Can I create a connection with the API?
No. In the automation API, you can only reference a connection that an organization admin already set up in Tape.
Why does my request fail after a few weeks?
Why does my request fail after a few weeks?
The connection may have expired. If it shows Broken, select ••• next to it, then Reauthorize.
Can I use my own API key instead of a connection?
Can I use my own API key instead of a connection?
Yes. Add the key as a header in Send HTTP request. Anyone who can edit the automation can read the key, so use a key with limited access.
Are you a developer using the Tape API for automations?
Are you a developer using the Tape API for automations?
The automation API has its own documentation for developers. Full reference: authenticated_http_call in the developer docs →
Still have questions? Find answers and get help from community experts in the Tape community →
