Moab logoMoab
Get started
Moab Docs

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 id
data_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

ParameterTypeKindDescription
company_idstringfilterThe companies row this person works at.
agent_idstringfilterThe campaign agent that currently owns this person.
created_by_agent_idstringfilterThe campaign agent that created this person. Read by the platform's object_created provenance hook to attribute the row's timeline entry.
sequence_idstringfilterThe sequences row this person is enrolled in, once a real send enrolls them.
seq_statusstringfilterWhere the person stands in the sequence; absent until a sequence starts.
list_idsarrayfilterThe lists this person belongs to, by id.
last_contacted_atdatefilterWhen 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_atdatefilterWhen 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_statusstringfilterThe 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).
qstringsearchFree-text search across name, title, email.
sortstringsortOne of next_touch_at, created_at; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_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

ParameterTypeKindDescription
idstringpathThe 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 person
data_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

FieldTypeRequiredDescription
namestringnoThe person's full name.
titlestringnoTheir job title at the company below.
companyobjectnoThe 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.namestringnoEmployer name, mirrored onto the person at write time so a list row needs no join.
  company.domainstringnoEmployer domain, mirrored the same way.
  company.summarytextnoOne plain sentence about what the employer does, mirrored onto the person.
  company.employee_countnumbernoHeadcount of the employer, mirrored onto the person.
company_idstringnoThe companies row this person works at.
emailstringnoWork email address — the send target for an email draft.
email_statusstringnoThe 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_atstringnoISO timestamp of the last verification that set email_status.
email_sourcestringnoWhich 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_urlstringnoLinkedIn 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_attributionobjectnoThe 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_idstringnoThe campaign agent whose sent draft reached this person.
  signup_attribution.content_idstringnoThe content piece the sent draft used.
  signup_attribution.outbox_idstringnoThe sent outbox row that closed the join.
  signup_attribution.page_idstringnoThe 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.atstringnoSignup time (ISO) from the analytics source.
list_idsarraynoThe lists this person belongs to, by id.
sequence_stepnumbernoWhich step of that sequence this person has reached.
seq_statusstringnoWhere the person stands in the sequence; absent until a sequence starts.
next_touch_atdatenoWhen the sequence next releases a touch to this person.
last_contacted_atdatenoWhen 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_channelstringnoChannel of that last delivery (email | linkedin). Stamped with last_contacted_at.
creation_reasontextnoWhy this person was added — the ICP evidence, in the researcher's words.
personastringnoThe buyer persona this person represents for the campaign.
signaltextnoThe 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_atdatenoWhen signal was last refreshed. A person signal goes stale fast (30d): a six-month-old "just launched" opener reads as canned.
content_typestringnoThe 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

FieldTypeRequiredDescription
namestringnoThe person's full name.
titlestringnoTheir job title at the company below.
companyobjectnoThe 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.namestringnoEmployer name, mirrored onto the person at write time so a list row needs no join.
  company.domainstringnoEmployer domain, mirrored the same way.
  company.summarytextnoOne plain sentence about what the employer does, mirrored onto the person.
  company.employee_countnumbernoHeadcount of the employer, mirrored onto the person.
company_idstringnoThe companies row this person works at.
emailstringnoWork email address — the send target for an email draft.
email_statusstringnoThe 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_atstringnoISO timestamp of the last verification that set email_status.
email_sourcestringnoWhich 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_urlstringnoLinkedIn 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_attributionobjectnoThe 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_idstringnoThe campaign agent whose sent draft reached this person.
  signup_attribution.content_idstringnoThe content piece the sent draft used.
  signup_attribution.outbox_idstringnoThe sent outbox row that closed the join.
  signup_attribution.page_idstringnoThe 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.atstringnoSignup time (ISO) from the analytics source.
list_idsarraynoThe lists this person belongs to, by id.
sequence_stepnumbernoWhich step of that sequence this person has reached.
seq_statusstringnoWhere the person stands in the sequence; absent until a sequence starts.
next_touch_atdatenoWhen the sequence next releases a touch to this person.
last_contacted_atdatenoWhen 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_channelstringnoChannel of that last delivery (email | linkedin). Stamped with last_contacted_at.
creation_reasontextnoWhy this person was added — the ICP evidence, in the researcher's words.
personastringnoThe buyer persona this person represents for the campaign.
signaltextnoThe 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_atdatenoWhen signal was last refreshed. A person signal goes stale fast (30d): a six-month-old "just launched" opener reads as canned.
content_typestringnoThe 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

FieldTypeRequiredDescription
eventstringyesThe human-readable timeline entry.
contextobjectnoProvenance — 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.

FieldTypeDescription
objectstringAlways person.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
email_provenancestringobserved | 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_idstringThe campaign agent that currently owns this person.
last_drafted_atdateWhen 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_idstringThe sequences row this person is enrolled in, once a real send enrolls them.
contacted_by_agent_idstringThe campaign agent whose draft made that last delivery. Stamped with last_contacted_at.
created_by_run_idstringThe campaign run that created this person — the run the "Runs" cell links to.
created_by_agent_idstringThe 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_labelstringThat 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_labelstringThe 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.