People

Log an outreach activity

Record that a teammate reached out to this person: an email, a DM, a call. The first activity claims an unowned person for whoever reached out and moves not_contacted to contacted; an existing owner and a later stage are kept. memberId defaults to the signed-in member; an API key that omits it logs an unattributed activity, which claims nobody. With groupId, the call works inside that keyword group: its people, and its own tags, notes, mute, merges and activities, apart from the workspace's and from every other group's.

post/v1/people/{id}/activities

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/people/{id}/activities
  • Auth: HTTP bearer

Path parameters

idstring required

Person id (aut_...).

Example:aut_abc123

Query parameters

groupIdstring

Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

Request body

channel'email' | 'x' | 'linkedin' | 'bluesky' | 'reddit' | 'github' | 'call' | 'meeting' | 'other' required

How they were reached: email, x, linkedin, bluesky, reddit, github, call, meeting or other.

notestring

What was sent or said, briefly.

occurredAtstring date-time

When the contact happened (ISO 8601, or epoch ms). Defaults to now.

memberIdstring

The member who reached out (user id). Defaults to the signed-in member; an API key that omits it logs an unattributed activity.

Response

The logged activity

idstring required

Activity id (act_...).

personIdstring required

The person it belongs to (aut_...).

channel'email' | 'x' | 'linkedin' | 'bluesky' | 'reddit' | 'github' | 'call' | 'meeting' | 'other' required

How they were reached: email, x, linkedin, bluesky, reddit, github, call, meeting or other.

notestring required

What was sent or said, briefly; empty when nothing was written.

occurredAtstring required

When the contact happened.

createdAtstring required

When it was logged.

Changes

No recorded changes to this operation across all 1 revision of this API.