KeyMetriq

Before you start

• You need to be an Owner or Admin in Magic Testimonials.

• You need a KeyMetriq workspace whose plan includes contacts. To create the key you must be an Owner or Admin of that workspace, or ask one of them to create it for you.

Get an API key from KeyMetriq

1. In KeyMetriq, open Settings, then API keys.

2. Click Create key, give it a name such as Magic Testimonials, and click Create key.

3. Click Copy key. The key is shown only once. If you lose it, revoke it and create a new one.

What the form asks for

• Name: a label for this connection in Magic Testimonials.

• KeyMetriq API key: the key you copied. It starts with km_live_.

Connect KeyMetriq

1. In Settings, click Integrations.

2. Under Lookup Sources, find KeyMetriq and click Connect. If another source is active, the button says Switch to KeyMetriq.

3. Paste the key into KeyMetriq API key.

4. Click Connect. We check the key before saving.

KeyMetriq now shows as Active. Connecting it replaces any other lookup source. If you are switching, read Integrations overview first, because Test connection turns your current source off.

What comes across

• Name

• Company

• Location, from the contact's country

Only empty fields are filled in. Integrations overview explains when a lookup runs.

A lookup can match any email address on a KeyMetriq contact, not only the main one. If the contact does not hold that exact address, we ignore the result, so a similar name or company cannot fill in the wrong details.

Find Email and Run sync search KeyMetriq by name. Contacts without an email address are left out. See Find author emails.

Stop the connection

Click Disconnect here, or revoke the key in KeyMetriq under Settings, API keys. A revoked key stops working straight away.

Let KeyMetriq read your testimonials

That is a separate connection, in the other direction. It uses an API token:

1. In Settings, click API tokens, then New token.

2. Click For KeyMetriq to choose the right scopes.

3. Create the token, copy it and enter it in KeyMetriq.

API tokens covers this step by step.

If something goes wrong

It says KeyMetriq API key is missing

The key field is empty. Paste the key you copied in KeyMetriq.

It says That API key was not accepted

The key is wrong, was revoked, or lost a character when it was copied. In KeyMetriq, open Settings, API keys and create a new key. Then click Disconnect here and connect again with the new key.

It says This KeyMetriq workspace's plan does not include contacts

The KeyMetriq workspace the key belongs to cannot share contacts on its current plan. Ask the owner of that workspace.

It says Could not reach KeyMetriq

Try again in a minute. If it keeps happening, contact support.

A testimonial did not get any details

The author's email must be on a KeyMetriq contact exactly. Try Find Email to search by name. See Integrations troubleshooting.