Skip to content
AptiroAptirodocs
Menu: Connect a people-data provider

Integrations

Connect a people-data provider

On this page

The UK company register lists the directors of UK companies, and nothing else. For companies elsewhere, such as US accounts, no public register lists the people who work there. A people-data provider does: it knows who works at a company, their job title, their work email and their LinkedIn address.

Aptiro can use a provider with your own account. You paste your provider's API key into Settings, and Aptiro asks the provider on your behalf. Aptiro does not hold a contract with the provider for you, and nothing is looked up until a member of your team starts a run.

The provider Aptiro works with is Apollo. You need an Apollo account and an API key from it.

Who can do what

Adding, replacing or removing the key, and reading its usage, needs permission to manage integrations. If you cannot see the People-data provider card in Settings > Integrations, your role does not hold it: ask an admin.

Add your key

  1. In your Apollo account, create an API key.
  2. In Aptiro, go to Settings > Integrations and find People-data provider.
  3. Paste the key into Provider key and press Save key.

The card then shows a Key set marker. The key is write-only: it is stored securely, tied to your organisation, and is never shown again, to anyone. To change it, enter a new key and press Replace key. To stop using the provider, press Remove key: the stored key is deleted. People already imported stay.

How Find people uses it

Once a key is set, Find people asks the provider as well as the UK register, for every account that has a website:

  • One account: the Find people button on the account runs the register and then the provider. The result says how many people came from each, for example "Suggested 3 people to add (1 from the UK company registry, 2 from the people-data provider)".
  • Every account: the Find people at every account run does the same for the whole organisation. The run summary says "Scanned 40 of 40 accounts, suggested 12 people (9 from the UK company registry, 3 from the people-data provider)".

The provider does not need a UK company number, so a US account, or a UK account you have not matched to the register yet, still gets people from it. An account that needs a register match is still listed under needs a match for the register, and the people the provider found for it are in the review list meanwhile. An account with no website is not sent to the provider. Each account asks about at most ten people.

If the provider cannot answer, the register is not affected:

  • Key rejected or out of credits: the provider is stopped for the rest of the run and the run shows one notice, "People-data provider: key rejected" or "People-data provider: out of credits". Replace the key or top up with your provider, then run again.
  • Busy or unavailable: that account is skipped and the run carries on with the next. Run it again later for the accounts that were skipped.

Usage

Once a key is set the card shows:

  • Lookups this month: how many people Aptiro has asked the provider about for your organisation in the current calendar month (UTC). Searching for people at a company is free at the provider. Looking up one person's details is what can use your provider credits, so this is the number to watch.
  • Provider requests left today, when the provider reports it for your key (it is refreshed every ten minutes, not on every visit). It is a count of requests, not your credit balance: check your credits in your provider account. If the provider does not report it, the card says so.

What is imported

For each person the provider returns, Aptiro suggests a contact with:

  • first and last name
  • job title
  • work email, when the provider holds one (personal emails are never requested)
  • LinkedIn address, when the provider holds one

Suggestions appear under People to review with the source shown as People-data provider, and the email and title filled in. They go through the same review as every other source. Nothing is added until it is accepted, and the same rules apply as for the UK register: a person you have erased or told Aptiro never to re-import is not suggested again, a person who already exists is matched rather than duplicated, a contact marked do not contact is never changed, and you can only add people to accounts you can reach.

Where a person's details came from is recorded on the contact, with the source shown as People-data provider: see see where a contact's details came from.

Where the data comes from and your lawful basis

The people and details come from your provider, not from the people themselves. Under UK and EU data protection law you stay responsible for having a lawful basis to hold and use them. Aptiro records legitimate interest as the lawful basis on every contact it creates from a provider, with the source and the date, so you can answer a person who asks where you got their details.

Legitimate interest is not automatic permission to email anyone: it needs a real, documented interest, a check that the contact is necessary for it, and a way for the person to object. A person can ask you to erase their data or to stop contacting them; erase the contact in Aptiro and they will not be suggested again. Check your provider's own terms for how its data may be used, and take your own advice on contacting people in a given country.

When something goes wrong

  • The provider rejected your key: the key is wrong, revoked or expired. Replace it.
  • Out of credits: top up with your provider, then run again.
  • Try again in a few minutes: the provider limits how often it can be asked. Wait, then try again.
  • Unavailable: the provider could not be reached. Try again later.

Last updated 2026-10-28

Search the documentation