People
The individuals Moab may draft outreach for.
Base path /api/v1/people on https://moabcrm.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.
List people
GET /api/v1/people
curl "https://moabcrm.com/api/v1/people?company_id=company-riverside-env" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest"Show me the people filtered by company iddata_query {
"collection": "people",
"where": {
"company_id": "company-riverside-env"
}
}Returns a paginated list of person objects, newest first.
{
"object": "list",
"data": [
{
"object": "person",
"id": "obj_123",
"name": "Dana Holt",
"title": "Director of Environmental Planning",
"company": {
"name": "Riverside Environmental Group",
"domain": "riversideenv.com",
"summary": "NEPA consulting firm serving federal land agencies; 48 staff.",
"employee_count": 48
},
"email": "dana@riversideenv.com",
"email_status": "email status",
"email_checked_at": "2026-07-25T12:00:00.000Z",
"email_source": "email source",
"email_provenance": "email provenance",
"linkedin_url": "linkedin url",
"last_drafted_at": "2026-07-25T12:00:00.000Z",
"signup_attribution": {
"agent_id": "agent_123",
"content_id": "content_123",
"outbox_id": "outbox_123",
"page_id": "page_123",
"at": "at"
},
"sequence_step": 1,
"seq_status": "seq status",
"next_touch_at": "2026-07-25T12:00:00.000Z",
"last_contacted_at": "2026-07-25T12:00:00.000Z",
"contacted_channel": "contacted channel",
"creation_reason": "Matched the small-environmental-firm ICP: NEPA consultancy under 200 staff with a named planning director.",
"persona": "Environmental planning lead at a small consulting firm",
"signal": "Riverside opened a second pit office in Q2 and is hiring NEPA planners.",
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}Parameters
| Parameter | Type | Kind | Description |
|---|---|---|---|
company_id | string | filter | The companies row this person works at. |
agent_id | string | filter | The campaign agent that currently owns this person. |
created_by_agent_id | string | filter | The campaign agent that created this person. Read by the platform's object_created provenance hook to attribute the row's timeline entry. |
sequence_id | string | filter | The sequences row this person is enrolled in, once a real send enrolls them. |
seq_status | string | filter | Where the person stands in the sequence; absent until a sequence starts. |
list_ids | array | filter | The lists this person belongs to, by id. |
last_contacted_at | date | filter | When a message was last DELIVERED to this person (ISO). Stamped by the server's delivery-completion hook at send time — never model-written. "Has this person been messaged" is this one field read; the drafts write gate refuses a new draft for a contacted person by name (person_already_contacted). |
last_drafted_at | date | filter | When the FIRST outbox draft named this person (ISO). Server-stamped at mint time — never model-written. A person with neither this nor last_contacted_at is the reusable pool; the stamp survives outside the bounded outbox scans the pool anti-join runs. |
email_status | string | filter | The last verification verdict for email — deliverable (passed the trust gate; the ONLY status a send may target) | undeliverable (positive evidence: failed verification or a hard bounce — the mint door refuses it) | risky (catch-all domain, gateway, disposable, or role address — never a false deliverable) | unknown (not decidable yet; retry later, never treated as bad). |
q | string | search | Free-text search across name, title, email. |
sort | string | sort | One of next_touch_at, created_at; prefix with - to reverse. |
limit | number | page | Rows to return, 1–100. Defaults to 20. |
cursor | string | page | next_cursor from the previous page. |
Retrieve a person
GET /api/v1/people/draft-001
curl "https://moabcrm.com/api/v1/people/draft-001" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest"Open the person {id}data_get {
"collection": "people",
"object_id": "draft-001"
}Returns the person object.
{
"object": "person",
"id": "obj_123",
"name": "Dana Holt",
"title": "Director of Environmental Planning",
"company": {
"name": "Riverside Environmental Group",
"domain": "riversideenv.com",
"summary": "NEPA consulting firm serving federal land agencies; 48 staff.",
"employee_count": 48
},
"email": "dana@riversideenv.com",
"email_status": "email status",
"email_checked_at": "2026-07-25T12:00:00.000Z",
"email_source": "email source",
"email_provenance": "email provenance",
"linkedin_url": "linkedin url",
"last_drafted_at": "2026-07-25T12:00:00.000Z",
"signup_attribution": {
"agent_id": "agent_123",
"content_id": "content_123",
"outbox_id": "outbox_123",
"page_id": "page_123",
"at": "at"
},
"sequence_step": 1,
"seq_status": "seq status",
"next_touch_at": "2026-07-25T12:00:00.000Z",
"last_contacted_at": "2026-07-25T12:00:00.000Z",
"contacted_channel": "contacted channel",
"creation_reason": "Matched the small-environmental-firm ICP: NEPA consultancy under 200 staff with a named planning director.",
"persona": "Environmental planning lead at a small consulting firm",
"signal": "Riverside opened a second pit office in Q2 and is hiring NEPA planners.",
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Parameter | Type | Kind | Description |
|---|---|---|---|
id | string | path | The person's id or slug. |
Create a person
POST /api/v1/people
curl -X POST "https://moabcrm.com/api/v1/people" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"name":"Dana Holt","title":"Director of Environmental Planning","email":"dana@riversideenv.com","company":{"name":"Riverside Environmental Group","domain":"riversideenv.com"},"company_id":"company-riverside-env","list_ids":["list-eplan-directors"]}'Create a new persondata_set {
"collection": "people",
"object_id": "draft-001",
"data": {
"name": "Dana Holt",
"title": "Director of Environmental Planning",
"email": "dana@riversideenv.com",
"company": {
"name": "Riverside Environmental Group",
"domain": "riversideenv.com"
},
"company_id": "company-riverside-env",
"list_ids": [
"list-eplan-directors"
]
}
}Returns the person object.
{
"object": "person",
"id": "obj_123",
"name": "Dana Holt",
"title": "Director of Environmental Planning",
"company": {
"name": "Riverside Environmental Group",
"domain": "riversideenv.com",
"summary": "NEPA consulting firm serving federal land agencies; 48 staff.",
"employee_count": 48
},
"email": "dana@riversideenv.com",
"email_status": "email status",
"email_checked_at": "2026-07-25T12:00:00.000Z",
"email_source": "email source",
"email_provenance": "email provenance",
"linkedin_url": "linkedin url",
"last_drafted_at": "2026-07-25T12:00:00.000Z",
"signup_attribution": {
"agent_id": "agent_123",
"content_id": "content_123",
"outbox_id": "outbox_123",
"page_id": "page_123",
"at": "at"
},
"sequence_step": 1,
"seq_status": "seq status",
"next_touch_at": "2026-07-25T12:00:00.000Z",
"last_contacted_at": "2026-07-25T12:00:00.000Z",
"contacted_channel": "contacted channel",
"creation_reason": "Matched the small-environmental-firm ICP: NEPA consultancy under 200 staff with a named planning director.",
"persona": "Environmental planning lead at a small consulting firm",
"signal": "Riverside opened a second pit office in Q2 and is hiring NEPA planners.",
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | The person's full name. |
title | string | no | Their job title at the company below. |
company | object | no | The employer's facts, mirrored onto the person at write time so no surface needs a join: name, domain, what it does, and headcount. The relational link is the top-level company_id. |
company.name | string | no | Employer name, mirrored onto the person at write time so a list row needs no join. |
company.domain | string | no | Employer domain, mirrored the same way. |
company.summary | text | no | One plain sentence about what the employer does, mirrored onto the person. |
company.employee_count | number | no | Headcount of the employer, mirrored onto the person. |
company_id | string | no | The companies row this person works at. |
email | string | no | Work email address — the send target for an email draft. |
email_status | string | no | The last verification verdict for email — deliverable (passed the trust gate; the ONLY status a send may target) | undeliverable (positive evidence: failed verification or a hard bounce — the mint door refuses it) | risky (catch-all domain, gateway, disposable, or role address — never a false deliverable) | unknown (not decidable yet; retry later, never treated as bad). |
email_checked_at | string | no | ISO timestamp of the last verification that set email_status. |
email_source | string | no | Which rung PRODUCED the address — the finder's provenance, never the verdict's (house_smtp | house_deterministic | enrow | prospeo) | operator (hand-entered). Older rows may name deleted rungs (generect, hunter, mailto_hunt, removed 2026-09-22). ONE enum the server resolver stamps when it finds the address; never model-written free text. The verdict is email_status + email_checked_at, and nothing re-stamps this field from a verdict (bounce-truth plan F5, 2026-09-13): the people write door used to overwrite it with the verify source on every write, which for a bounced address was the cache row's word and erased the finder. A bounce KEEPS it (bounce-revocation.ts) so bounces are attributable. |
linkedin_url | string | no | LinkedIn profile URL — the send target for a LinkedIn draft, the way email is for an email draft. Required by HeyReach connection requests; a person without one cannot receive a LinkedIn draft. |
signup_attribution | object | no | The attributed signup join — { agent_id, content_id, outbox_id, page_id?, at }. Reconciled by the destination service from exact code, recipient and delivery evidence; counted by the server engagement score. Corrections retain an audit event. |
signup_attribution.agent_id | string | no | The campaign agent whose sent draft reached this person. |
signup_attribution.content_id | string | no | The content piece the sent draft used. |
signup_attribution.outbox_id | string | no | The sent outbox row that closed the join. |
signup_attribution.page_id | string | no | The landing page the signup came through, when the join's link_codes row carries one (outbox → link_codes.page_id) — the pages engagement stamp counts signups by this hop. Only ever from a record read this run, never inferred. |
signup_attribution.at | string | no | Signup time (ISO) from the analytics source. |
list_ids | array | no | The lists this person belongs to, by id. |
sequence_step | number | no | Which step of that sequence this person has reached. |
seq_status | string | no | Where the person stands in the sequence; absent until a sequence starts. |
next_touch_at | date | no | When the sequence next releases a touch to this person. |
last_contacted_at | date | no | When a message was last DELIVERED to this person (ISO). Stamped by the server's delivery-completion hook at send time — never model-written. "Has this person been messaged" is this one field read; the drafts write gate refuses a new draft for a contacted person by name (person_already_contacted). |
contacted_channel | string | no | Channel of that last delivery (email | linkedin). Stamped with last_contacted_at. |
creation_reason | text | no | Why this person was added — the ICP evidence, in the researcher's words. |
persona | string | no | The buyer persona this person represents for the campaign. |
signal | text | no | The one person-level research observation personalization may open on — a launch, a hire, a post, a repo. Cached here so the next campaign personalizes for zero searches. |
last_researched_at | date | no | When signal was last refreshed. A person signal goes stale fast (30d): a six-month-old "just launched" opener reads as canned. |
content_type | string | no | The kind of content this person was sourced for ("email" / "linkedin_message"), written by the audience pass when known. |
Update a person
PATCH /api/v1/people/draft-001
curl -X PATCH "https://moabcrm.com/api/v1/people/draft-001" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"name":"name","title":"title","company":{"name":"name","domain":"example.com","summary":"summary","employee_count":1}}'Update the person {id}data_set {
"collection": "people",
"object_id": "draft-001",
"data": {
"name": "name",
"title": "title",
"company": {
"name": "name",
"domain": "example.com",
"summary": "summary",
"employee_count": 1
}
}
}Returns the person object.
{
"object": "person",
"id": "obj_123",
"name": "Dana Holt",
"title": "Director of Environmental Planning",
"company": {
"name": "Riverside Environmental Group",
"domain": "riversideenv.com",
"summary": "NEPA consulting firm serving federal land agencies; 48 staff.",
"employee_count": 48
},
"email": "dana@riversideenv.com",
"email_status": "email status",
"email_checked_at": "2026-07-25T12:00:00.000Z",
"email_source": "email source",
"email_provenance": "email provenance",
"linkedin_url": "linkedin url",
"last_drafted_at": "2026-07-25T12:00:00.000Z",
"signup_attribution": {
"agent_id": "agent_123",
"content_id": "content_123",
"outbox_id": "outbox_123",
"page_id": "page_123",
"at": "at"
},
"sequence_step": 1,
"seq_status": "seq status",
"next_touch_at": "2026-07-25T12:00:00.000Z",
"last_contacted_at": "2026-07-25T12:00:00.000Z",
"contacted_channel": "contacted channel",
"creation_reason": "Matched the small-environmental-firm ICP: NEPA consultancy under 200 staff with a named planning director.",
"persona": "Environmental planning lead at a small consulting firm",
"signal": "Riverside opened a second pit office in Q2 and is hiring NEPA planners.",
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | no | The person's full name. |
title | string | no | Their job title at the company below. |
company | object | no | The employer's facts, mirrored onto the person at write time so no surface needs a join: name, domain, what it does, and headcount. The relational link is the top-level company_id. |
company.name | string | no | Employer name, mirrored onto the person at write time so a list row needs no join. |
company.domain | string | no | Employer domain, mirrored the same way. |
company.summary | text | no | One plain sentence about what the employer does, mirrored onto the person. |
company.employee_count | number | no | Headcount of the employer, mirrored onto the person. |
company_id | string | no | The companies row this person works at. |
email | string | no | Work email address — the send target for an email draft. |
email_status | string | no | The last verification verdict for email — deliverable (passed the trust gate; the ONLY status a send may target) | undeliverable (positive evidence: failed verification or a hard bounce — the mint door refuses it) | risky (catch-all domain, gateway, disposable, or role address — never a false deliverable) | unknown (not decidable yet; retry later, never treated as bad). |
email_checked_at | string | no | ISO timestamp of the last verification that set email_status. |
email_source | string | no | Which rung PRODUCED the address — the finder's provenance, never the verdict's (house_smtp | house_deterministic | enrow | prospeo) | operator (hand-entered). Older rows may name deleted rungs (generect, hunter, mailto_hunt, removed 2026-09-22). ONE enum the server resolver stamps when it finds the address; never model-written free text. The verdict is email_status + email_checked_at, and nothing re-stamps this field from a verdict (bounce-truth plan F5, 2026-09-13): the people write door used to overwrite it with the verify source on every write, which for a bounced address was the cache row's word and erased the finder. A bounce KEEPS it (bounce-revocation.ts) so bounces are attributable. |
linkedin_url | string | no | LinkedIn profile URL — the send target for a LinkedIn draft, the way email is for an email draft. Required by HeyReach connection requests; a person without one cannot receive a LinkedIn draft. |
signup_attribution | object | no | The attributed signup join — { agent_id, content_id, outbox_id, page_id?, at }. Reconciled by the destination service from exact code, recipient and delivery evidence; counted by the server engagement score. Corrections retain an audit event. |
signup_attribution.agent_id | string | no | The campaign agent whose sent draft reached this person. |
signup_attribution.content_id | string | no | The content piece the sent draft used. |
signup_attribution.outbox_id | string | no | The sent outbox row that closed the join. |
signup_attribution.page_id | string | no | The landing page the signup came through, when the join's link_codes row carries one (outbox → link_codes.page_id) — the pages engagement stamp counts signups by this hop. Only ever from a record read this run, never inferred. |
signup_attribution.at | string | no | Signup time (ISO) from the analytics source. |
list_ids | array | no | The lists this person belongs to, by id. |
sequence_step | number | no | Which step of that sequence this person has reached. |
seq_status | string | no | Where the person stands in the sequence; absent until a sequence starts. |
next_touch_at | date | no | When the sequence next releases a touch to this person. |
last_contacted_at | date | no | When a message was last DELIVERED to this person (ISO). Stamped by the server's delivery-completion hook at send time — never model-written. "Has this person been messaged" is this one field read; the drafts write gate refuses a new draft for a contacted person by name (person_already_contacted). |
contacted_channel | string | no | Channel of that last delivery (email | linkedin). Stamped with last_contacted_at. |
creation_reason | text | no | Why this person was added — the ICP evidence, in the researcher's words. |
persona | string | no | The buyer persona this person represents for the campaign. |
signal | text | no | The one person-level research observation personalization may open on — a launch, a hire, a post, a repo. Cached here so the next campaign personalizes for zero searches. |
last_researched_at | date | no | When signal was last refreshed. A person signal goes stale fast (30d): a six-month-old "just launched" opener reads as canned. |
content_type | string | no | The kind of content this person was sourced for ("email" / "linkedin_message"), written by the audience pass when known. |
Append an event to a person
POST /api/v1/people/{id}/events
curl -X POST "https://moabcrm.com/api/v1/people/draft-001/events" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_zest" \
-H "Content-Type: application/json" \
-d '{"event":"Noted by the operator","context":{"source":"api"}}'Add a note to the person {id}data_event {
"collection": "people",
"object_id": "draft-001",
"event": "Noted by the operator"
}Returns the appended event object.
{
"object": "event",
"id": "evt_123",
"event": "Noted by the operator"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
event | string | yes | The human-readable timeline entry. |
context | object | no | Provenance — source, integration, worker_run_id, … |
What comes back (read-only)
Every person carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.
| Field | Type | Description |
|---|---|---|
object | string | Always person. |
id | string | Stable object id. Also accepted in place of slug on any path. |
slug | string | URL-safe name, unique within the collection. |
created_at | string | ISO-8601 timestamp of the first write. |
updated_at | string | ISO-8601 timestamp of the most recent write. The cursor sorts on this. |
email_provenance | string | observed | generated — door-stamped from the EmailService's resolve outcome (emailProvenanceForProvider): observed when a provider INDEX carried the address (a paid people-index or a scrape of a published address), generated when we derived it (permutation, stored, cache). Kept as a fact about the address; since 2026-09-22 (D5) it is NOT a gate of isGoldenPerson — a house-verified address counts as good. The model never writes it. |
agent_id | string | The campaign agent that currently owns this person. |
last_drafted_at | date | When the FIRST outbox draft named this person (ISO). Server-stamped at mint time — never model-written. A person with neither this nor last_contacted_at is the reusable pool; the stamp survives outside the bounded outbox scans the pool anti-join runs. |
sequence_id | string | The sequences row this person is enrolled in, once a real send enrolls them. |
contacted_by_agent_id | string | The campaign agent whose draft made that last delivery. Stamped with last_contacted_at. |
created_by_run_id | string | The campaign run that created this person — the run the "Runs" cell links to. |
created_by_agent_id | string | The campaign agent that created this person. Read by the platform's object_created provenance hook to attribute the row's timeline entry. |
created_by_agent_label | string | That agent's NAME, denormalised alongside created_by_agent_id so the provenance chip and the timeline author link render without a join. |
created_by_list_label | string | The name of the list this person was sourced from, denormalised the same way. |
Errors
Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.