Get started

Quickstart

Make your first authenticated request in under five minutes.

1. Get an API key

In the app, open Support & Billing → Access & tokens (Admin) and create an API key. Keys are workspace-scoped and shown once — store it securely, server-side.

2. Make a request

List the contacts in your workspace:

GET/v1/contacts

bash

curl https://api.n7fora.com/v1/contacts \
  -H "Authorization: Bearer $N7FORA_API_KEY"

3. Read the response

json

{
  "object": "list",
  "data": [
    {
      "id": "ctc_amara_okafor",
      "name": "Amara Okafor",
      "title": "Managing Partner",
      "company": "Kestrel Capital",
      "health": "warm",
      "last_touch": "2026-07-11T09:30:00Z",
      "tags": ["investor", "climate"]
    }
  ],
  "has_more": false
}

4. Capture a contact

Create a contact from a scanned card or parsed signature. Capture writes are immediate; downstream actions (outreach, enrichment) stay gated behind your confirmation.

POST/v1/capture

bash

curl https://api.n7fora.com/v1/capture \
  -H "Authorization: Bearer $N7FORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Yuki Mori",
    "company": "Aozora Ventures",
    "email": "y.mori@aozora.vc",
    "source": "business_card"
  }'

Never embed API keys in client-side code. Call the API from your server, and treat keys like passwords.

Next: Authentication · API Reference