Apollo OAuth
Overview
Pre-built tooling
✅ Authorization
| Tools | Status |
|---|---|
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Auth parameters validation | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
✅ Read & write data
| Tools | Status |
|---|---|
| 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
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-end type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
| Tools | Status |
|---|---|
| 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 name | Description | Type | Source code |
|---|---|---|---|
bulk-enrich-people | Bulk enrich people by emails or IDs. Supports up to 10 people per request. | Action | 🔗 Github |
create-account | Create an account in Apollo. | Action | 🔗 Github |
create-contact | Create a contact in Apollo. | Action | 🔗 Github |
create-opportunity | Create an opportunity in Apollo | Action | 🔗 Github |
create-task | Create a task in Apollo | Action | 🔗 Github |
delete-account | Delete or archive an account in Apollo by setting its existence_level to none | Action | 🔗 Github |
delete-contact | Delete or archive a contact in Apollo | Action | 🔗 Github |
delete-opportunity | Archive (soft-delete) an opportunity in Apollo by marking it as closed. | Action | 🔗 Github |
enrich-organization | Enrich an organization by domain or Apollo ID | Action | 🔗 Github |
enrich-person | Enrich a person by email or Apollo ID | Action | 🔗 Github |
get-account | Retrieve a single account from Apollo. | Action | 🔗 Github |
get-contact | Retrieve a single contact from Apollo. | Action | 🔗 Github |
get-opportunity | Retrieve a single opportunity from Apollo. | Action | 🔗 Github |
list-accounts | List accounts from Apollo. | Action | 🔗 Github |
list-contacts | List contacts from Apollo. | Action | 🔗 Github |
list-opportunities | List opportunities from Apollo. | Action | 🔗 Github |
list-sequences | List sequences from Apollo. | Action | 🔗 Github |
list-tasks | List tasks from Apollo | Action | 🔗 Github |
list-users | List users (team members) in the Apollo organisation. | Action | 🔗 Github |
remove-contact-from-sequence | Remove or stop one or more contacts from an Apollo sequence. | Action | 🔗 Github |
search-organizations | Search Apollo organization records. | Action | 🔗 Github |
search-people | Search Apollo people records | Action | 🔗 Github |
update-account | Update an account in Apollo | Action | 🔗 Github |
update-contact | Update a contact in Apollo. | Action | 🔗 Github |
update-opportunity | Update an opportunity in Apollo. | Action | 🔗 Github |
update-task | Update 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 |
accounts | Sync accounts from Apollo | Sync | 🔗 Github |
contacts | Sync contacts from Apollo | Sync | 🔗 Github |
opportunities | Sync opportunities from Apollo | Sync | 🔗 Github |
organization-search | Sync organizations matching saved Apollo filters | Sync | 🔗 Github |
sequences | Sync sequences from Apollo. | Sync | 🔗 Github |
tasks | Sync tasks from Apollo. | Sync | 🔗 Github |
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free, self-signup here. |
| Paid test account | ✅ Not required | Free, self-signup here. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | Required 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
Launch Apollo and click on Settings > Integrations. Find the API option and click Connect. Select OAuth registration and enter the required 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/callbackfor the redirect URL. - Scopes: Set the necessary scopes for your app. Apollo adds
read_user_profileandapp_scopesby default.
Click Submit to complete the registration. Once submitted, copy the generated Client ID and Client secret for use in the next steps.
Follow the Quickstart.
Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Useful links
- How to register your Oauth Application
- OAuth related docs
- List of OAuth scopes
- Apollo API docs
- API rate liming
Contribute useful links by editing this page
API gotchas
None yet, add yours!
Contribute API gotchas by editing this page