- Overview
- Configuration
Apollo
Improve sales operations by aligning Apollo CRM user data with IT systems.
Overview
Apollo is a data-driven sales engagement platform that helps teams find, engage, and convert prospects more effectively. With the ADManager Plus integration, organizations can streamline how user accounts are managed between Active Directory (AD) and Apollo, enabling real-time updates and eliminating the need for repetitive manual user management tasks.
Sync Apollo user records in AD
Using the Get Users endpoint, ADManager Plus can pull existing user data from Apollo, giving IT administrators visibility into active users within the platform. This capability is useful for cross-verification, audit readiness, and maintaining consistency between AD and Apollo user directories.
Seamless user account updates
ADManager Plus enables automatic creation and updating of user accounts in Apollo based on changes made in Active Directory. Whether you're onboarding a new sales rep or updating user attributes like role or email, these changes can be synced instantly with Apollo—ensuring users always have the right level of access and up-to-date profiles without administrative delays.
How to integrate Apollo with ADManager Plus
Prerequisites:
Apollo uses OAuth 2.0 to authorize API requests. Please ensure to provide the client_id and client_secret with permissions to retrieve desired information and perform tasks in Apollo. Refer to the Apollo API references page for more details.
Privileges:
- To import users (inbound action): Ensure the account used for authorization has permission to read all user accounts.
- To perform any action or query in Apollo (outbound action): Ensure the account used for authorization has permission to perform the desired action.
Authorization configuration
- Log in to ADManager Plus and navigate to Directory/Application Settings.
- Go to Application Integrations, then search and select Apollo.
- Toggle the Enable Apollo Integration button on.
- In the Apollo Configuration page, click Authorization.
- Perform steps to generate client_id and client_secret from Apollo, and paste them in the respective value fields.
- Enter Authorization Code as Grant Type
- Click Configure.
Inbound webhook configuration
The inbound webhook enables you to get user data from Apollo to ADManager Plus and perform desired action available in Automation feature on them. To configure an inbound webhook for Apollo:
- Under Inbound Webhook, click Apollo Endpoint Configuration.
- In the Endpoint Configuration tab, an endpoint, Apollo GET USERS ENDPOINT, comes preconfigured with an Endpoint URL, API Method, Headers, and Parameters fields to fetch user accounts from Apollo. If you would like to use this preconfigured endpoint, replace {Master API Key} with that of your Apollo instance in the Endpoint URL field. However, if you would like to use a new endpoint to import users, you can configure one using the + Add API endpoint button and filling in the required fields per Apollo's API references. Click here to learn how. Note:
- The API key value pair is preconfigured as a header for authenticating API requests as configured during Authorization Configuration.
- You can add macros to your endpoint configuration to dynamically change it as per your requirement using the macro chooser component
- Refer to Apollo's API references and configure additional headers and parameters, if required.
- Once done, click Test & Save. A response window will display all the requested parameters that can be fetched using the API call. Click Proceed. Note:
- Refer to Apollo's API references to know the Parameters that must be configured to fetch specific parameters.
- You can configure multiple endpoints for Apollo using the + Add API endpoint button. Click here to learn how.
- Click Data Source - LDAP Attribute Mapping to match endpoints and to map AD LDAP attributes with the respective attributes in Apollo.
- Click + Add New Configuration and perform the following:
- Enter the Configuration Name and Description and select the Automation Category from the drop-down menu.
- In the Select Endpoint field, select the desired endpoint and a Primary Key that is unique to a user (e.g. employeeIdentifier). Note: When multiple endpoints are configured, this attribute must hold the same value in all the endpoints.
- In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu and map it with the respective column in Apollo.
- If you would like to create a new custom format for this, click Mapping Attribute.
- Click Save.
Outbound webhook configuration
Outbound webhook enables you to update the changes made in AD using ADManager Plus to Apollo or forward required details from Apollo and synchronize them with AD.
- To configure an outbound webhook for Apollo:
- Under Outbound Webhook, click Apollo Webhook Configuration.
- Click + Add Webhook.
- Enter a name and description for this webhook.
- Decide on the action that has to be performed and refer to Apollo's API references for the API details, such as the URL, headers, parameters, and other requirements
- Select the HTTP method that will enable you to perform the desired action on the endpoint from the drop-down menu.
- Enter the endpoint URL.
- Configure the Headers, Parameters, and Message Type in the appropriate format based on the API call that you would like to perform.
- Click Test and Save.
- A pop-up window will then display a list of AD users and groups to test the configured API call. Select the desired user or group for which this API request has to be tested and click OK. This will make a real-time call to the endpoint URL, and the selected object will be modified as per the configuration.
- The webhook response and request details will then be displayed. Verify them for the expected API behavior and click Save.