Build your first List

const BASE = "https://api.reversecontact.com";
const headers = {
  "Authorization": `Bearer ${process.env.RC_API_KEY}`,
  "Content-Type": "application/json"
};

// 1. Create the List: the Idempotency-Key makes a retry safe
const list = await fetch(`${BASE}/v2/lists`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": "q4-sales-leaders" },
  body: JSON.stringify({ name: "Q4 sales leaders", entity: "persons" })
}).then((res) => res.json());
const listId = list.data.id;

// 2. Import the people and buy their emails, 50 credits at most
const queued = await fetch(`${BASE}/v2/lists/${listId}/intake/signals`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    operationId: crypto.randomUUID(), // keep it to resume the import
    signals: [
      { linkedinUrl: "https://www.social.com/in/janedoe", externalId: "crm-001" },
      { email: "john.smith@acme.com", externalId: "crm-002" },
      { firstName: "Alex", lastName: "Martin", companyDomain: "acme.com", externalId: "crm-003" }
    ],
    families: ["contact_email"],
    maxCredits: 50
  })
}).then((res) => res.json());

// 3. Follow the import until it stops moving
let operation;
do {
  const res = await fetch(`${BASE}${queued.data.pollUrl}?wait=20`, { headers });
  operation = (await res.json()).data;
} while (operation.clientAction === "poll");
if (operation.status !== "completed") throw new Error(operation.nextStep?.message ?? `Import ${operation.status}`);

// 4. Read the members and their emails
const members = await fetch(`${BASE}/v2/lists/${listId}/members?kind=members`, { headers }).then((res) => res.json());
for (const member of members.data.items) {
  console.log(member.externalId, member.fields.name, member.families.contactEmail?.value ?? "no email");
}

import os
import uuid
import requests

BASE = "https://api.reversecontact.com"
headers = {
    "Authorization": f"Bearer {os.environ['RC_API_KEY']}",
    "Content-Type": "application/json",
}

# 1. Create the List: the Idempotency-Key makes a retry safe
list_ = requests.post(
    f"{BASE}/v2/lists",
    headers={**headers, "Idempotency-Key": "q4-sales-leaders"},
    json={"name": "Q4 sales leaders", "entity": "persons"},
).json()
list_id = list_["data"]["id"]

# 2. Import the people and buy their emails, 50 credits at most
queued = requests.post(
    f"{BASE}/v2/lists/{list_id}/intake/signals",
    headers=headers,
    json={
        "operationId": str(uuid.uuid4()),  # keep it to resume the import
        "signals": [
            {"linkedinUrl": "https://www.social.com/in/janedoe", "externalId": "crm-001"},
            {"email": "john.smith@acme.com", "externalId": "crm-002"},
            {"firstName": "Alex", "lastName": "Martin", "companyDomain": "acme.com", "externalId": "crm-003"},
        ],
        "families": ["contact_email"],
        "maxCredits": 50,
    },
).json()

# 3. Follow the import until it stops moving
while True:
    operation = requests.get(
        f"{BASE}{queued['data']['pollUrl']}", headers=headers, params={"wait": 20}, timeout=30
    ).json()["data"]
    if operation["clientAction"] != "poll":
        break
if operation["status"] != "completed":
    raise RuntimeError((operation.get("nextStep") or {}).get("message") or f"Import {operation['status']}")

# 4. Read the members and their emails
members = requests.get(f"{BASE}/v2/lists/{list_id}/members", headers=headers, params={"kind": "members"}).json()
for member in members["data"]["items"]:
    email = (member["families"].get("contactEmail") or {}).get("value", "no email")
    print(member.get("externalId"), member["fields"].get("name"), email)

import ReverseContact from "@reverse-contact/sdk";

const client = new ReverseContact({ apiKey: process.env.RC_API_KEY });

// 1. Create the List: the SDK sends an Idempotency-Key and reuses it on its retries
const list = await client.lists.create({ name: "Q4 sales leaders", entity: "persons" });
const listId = list.data.id;

// 2. Import the people and buy their emails, 50 credits at most
const queued = await client.lists.importSignals(listId, {
  signals: [
    { linkedinUrl: "https://www.social.com/in/janedoe", externalId: "crm-001" },
    { email: "john.smith@acme.com", externalId: "crm-002" },
    { firstName: "Alex", lastName: "Martin", companyDomain: "acme.com", externalId: "crm-003" }
  ],
  families: ["contact_email"],
  maxCredits: 50
});

// 3. Follow the import until it stops moving
const operation = await client.lists.operations.wait(listId, queued.data.operationId);
console.log(operation.data.status, operation.data.clientAction);

// 4. Read the members and their emails
for await (const member of client.lists.members.listAll(listId, { kind: "members" })) {
  console.log(member);
}

import os

from reversecontact import ReverseContact

with ReverseContact(api_key=os.environ["RC_API_KEY"]) as client:
    # 1. Create the List: the SDK sends an Idempotency-Key and reuses it on its retries
    list_id = client.lists.create(name="Q4 sales leaders", entity="persons").data.id

    # 2. Import the people and buy their emails, 50 credits at most
    queued = client.lists.import_signals(
        list_id,
        signals=[
            {"linkedinUrl": "https://www.social.com/in/janedoe", "externalId": "crm-001"},
            {"email": "john.smith@acme.com", "externalId": "crm-002"},
            {"firstName": "Alex", "lastName": "Martin", "companyDomain": "acme.com", "externalId": "crm-003"},
        ],
        families=["contact_email"],
        max_credits=50,
    )

    # 3. Follow the import until it stops moving
    operation = client.lists.operations.wait(list_id, queued.data.operation_id)
    print(operation.data.status, operation.data.client_action)

    # 4. Read the members and their emails
    for member in client.lists.members.list_all(list_id, kind="members"):
        print(member)