REST API

Direct HTTP access. All endpoints accept and return JSON.

Base URL

https://api.nondual.cloud/v1

Authentication

Pass your key in the Authorization header on every request.

Authorization: Bearer ***

Get a key:

curl -s -X POST https://api.nondual.cloud/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

Agent attribution

Pass the calling agent name in the X-Nondual-Agent header on record and context calls. It is stored with every interaction and followup.

X-Nondual-Agent: my-sales-agent

POST /resolve

Resolve an email or LinkedIn URL to a full contact profile.

curl -s -X POST https://api.nondual.cloud/v1/resolve \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"contact":"dario@anthropic.com"}'

Request body:

Response:

{
  "contact": {
    "id": "contact_...",
    "name": "Dario Amodei",
    "identifiers": {
      "emails": ["dario@anthropic.com"],
      "linkedin_url": "https://linkedin.com/in/darioamodei",
      "phones": [],
      "handles": []
    },
    "profile": {
      "role": "Co-Founder & CEO",
      "about": "...",
      "location": "San Francisco, CA"
    },
    "company": { "name": "Anthropic", "domain": "anthropic.com" },
    "next": { "action": "Reach out via LinkedIn..." }
  }
}

POST /context

Get relationship context for a contact — profile, interaction history, open followups, next step.

curl -s -X POST https://api.nondual.cloud/v1/context \
  -H "Authorization: Bearer ***" \
  -H "X-Nondual-Agent: my-agent" \
  -H "Content-Type: application/json" \
  -d '{"contact":"dario@anthropic.com"}'

POST /interactions

Record an interaction after outreach.

curl -s -X POST https://api.nondual.cloud/v1/interactions \
  -H "Authorization: Bearer ***" \
  -H "X-Nondual-Agent: my-agent" \
  -H "Content-Type: application/json" \
  -d '{"contact":"dario@anthropic.com","channel":"email","direction":"outbound","summary":"Sent intro","details":"Full email body..."}'

POST /followups

Create a follow-up task.

curl -s -X POST https://api.nondual.cloud/v1/followups \
  -H "Authorization: Bearer ***" \
  -H "X-Nondual-Agent: my-agent" \
  -H "Content-Type: application/json" \
  -d '{"contact":"dario@anthropic.com","action":"Follow up with proposal","due":"2026-07-25"}'

Errors

All error responses follow:

{ "error": "code", "message": "description" }