From a workspace key to a work email.

Create a named API key.

1. Create an account or log in to your existing workspace.
2. Open Dashboard → Developers and create a key named for this integration.
3. Save the full key when it is displayed. Keep it in your secret manager; it cannot be retrieved again.

Use a separate key for each integration so you can revoke one without disrupting the others. The free plan includes 20 emails and 5 business-phone results; see pricing for the current plans.

Configure your backend environment.

Set these values in your server’s environment. The production base URL is shown below. Load your actual key from secret storage.

TARGETWISE_BASE_URL=https://targetwise.ai/api/v1
TARGETWISE_API_KEY=YOUR_TARGETWISE_KEY

The snippet lists environment values; configure them through your deployment settings or environment loader. It does not set them in your current shell. Keep the key out of source control and client-side code.

Request one work email.

Use the first and last name with a company domain, as shown below. Alternatively, send only linkedin_url. Replace these illustrative values with a real test record you are permitted to process.

curl --fail-with-body "$TARGETWISE_BASE_URL/contacts/find-work-email" \
  -H "Authorization: Bearer $TARGETWISE_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"first_name":"Alex","last_name":"Reed","company_domain":"example.com"}'

This endpoint requests email only. For both email and phone, use contact enrichment and set the field switches explicitly.

Handle the result before using the field.

An HTTP 200 confirms that the lookup completed. It does not guarantee that an email exists. Add this branch after the JavaScript request example above.

const email = result.data?.work_email;

if (result.status === "not_found") {
  console.log("No email found for this identifier.");
} else if (typeof email === "string" && email.length > 0) {
  // Apply identity and merge rules before storing the email.
  // Avoid logging the email or full contact record.
  console.log("Work email available.", result.request_id);
} else {
  console.log("Required field unavailable.", result.request_id);
  // Keep unresolved_fields with the application event.
}

Open Usage in your dashboard to inspect workspace activity after testing. Retain the response’s request_id for troubleshooting.

Extend the workflow when the first call works.

If the first request does not work.

For other responses, use the error reference.

Common questions