Apollo OAuth

Overview

Pre-built tooling

✅ Authorization
ToolsStatus
Pre-built authorization (OAuth)✅
Credentials auto-refresh✅
Auth parameters validation✅
Pre-built authorization UI✅
Custom authorization UI✅
Expired credentials detection✅
✅ Read & write data
ToolsStatus
Pre-built integrations✅
API unification✅
2-way sync✅
Webhooks from Tenklo on data modifications✅
Real-time webhooks from 3rd-party API🚫 (time to contribute: <48h)
Proxy requests✅
✅ Observability & data quality
ToolsStatus
HTTP request logging✅
End-to-end type safety✅
Data runtime validation✅
OpenTelemetry export✅
Slack alerts on errors✅
Integration status API✅
✅ Customization
ToolsStatus
Create or customize use-cases✅
Pre-configured pagination🚫 (time to contribute: <48h)
Pre-configured rate-limit handling🚫 (time to contribute: <48h)
Per-customer configurations✅

Others

Function nameDescriptionTypeSource code
bulk-enrich-peopleBulk enrich people by emails or IDs. Supports up to 10 people per request.Action🔗 Github
create-accountCreate an account in Apollo.Action🔗 Github
create-contactCreate a contact in Apollo.Action🔗 Github
create-opportunityCreate an opportunity in ApolloAction🔗 Github
create-taskCreate a task in ApolloAction🔗 Github
delete-accountDelete or archive an account in Apollo by setting its existence_level to noneAction🔗 Github
delete-contactDelete or archive a contact in ApolloAction🔗 Github
delete-opportunityArchive (soft-delete) an opportunity in Apollo by marking it as closed.Action🔗 Github
enrich-organizationEnrich an organization by domain or Apollo IDAction🔗 Github
enrich-personEnrich a person by email or Apollo IDAction🔗 Github
get-accountRetrieve a single account from Apollo.Action🔗 Github
get-contactRetrieve a single contact from Apollo.Action🔗 Github
get-opportunityRetrieve a single opportunity from Apollo.Action🔗 Github
list-accountsList accounts from Apollo.Action🔗 Github
list-contactsList contacts from Apollo.Action🔗 Github
list-opportunitiesList opportunities from Apollo.Action🔗 Github
list-sequencesList sequences from Apollo.Action🔗 Github
list-tasksList tasks from ApolloAction🔗 Github
list-usersList users (team members) in the Apollo organisation.Action🔗 Github
remove-contact-from-sequenceRemove or stop one or more contacts from an Apollo sequence.Action🔗 Github
search-organizationsSearch Apollo organization records.Action🔗 Github
search-peopleSearch Apollo people recordsAction🔗 Github
update-accountUpdate an account in ApolloAction🔗 Github
update-contactUpdate a contact in Apollo.Action🔗 Github
update-opportunityUpdate an opportunity in Apollo.Action🔗 Github
update-taskUpdate a task in Apollo. Note: Due to OAuth limitations, the original task cannot be directly modified or deleted. A new task is created with the updated fields, and the original task should be manually deleted in the Apollo UI.Action🔗 Github
accountsSync accounts from ApolloSync🔗 Github
contactsSync contacts from ApolloSync🔗 Github
opportunitiesSync opportunities from ApolloSync🔗 Github
organization-searchSync organizations matching saved Apollo filtersSync🔗 Github
sequencesSync sequences from Apollo.Sync🔗 Github
tasksSync tasks from Apollo.Sync🔗 Github

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup here.
Paid test account✅ Not requiredFree, self-signup here.
Partnership✅ Not required
App review✅ Not requiredRequired only if you plan to list your integration on the Apollo Marketplace. Not needed for general integration use or distribution.
Security audit✅ Not required

Setup guide

Register your app with Apollo

Launch Apollo and click on Settings > Integrations. Find the API option and click Connect. Select OAuth registration and enter the required details.

Provide App Details

Enter the following information:

  • App Name: The name of your app or product.
  • App Logo: Upload the logo for your app.
  • OAuth Redirect URL: The URL that users will be redirected to after they authorize your app. Use https://api.tenklo.dev/oauth/callback for the redirect URL.
  • Scopes: Set the necessary scopes for your app. Apollo adds read_user_profile and app_scopes by default.

Submit the Registration

Click Submit to complete the registration. Once submitted, copy the generated Client ID and Client secret for use in the next steps.

Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Contribute useful links by editing this page

API gotchas

None yet, add yours!

Contribute API gotchas by editing this page

On this page