OverviewAPI Reference
People

Merge an account into a person

Declare that this account and another person are the same human, for your workspace only. Their mentions, tags, notes and outreach activities combine under the person named by `into`, which keeps its owner and stage unless it had none.

POST
/v1/people/{id}/merge

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Path Parameters

idstring

Person id (aut_...).

Length1 <= length

Request Body

intostring

The person to fold this account into (their id).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X POST "https://api.mentio.dev/v1/people/aut_abc123/merge" \  -H "Content-Type: application/json" \  -d '{    "into": "string"  }'
{
  "id": "string",
  "platform": "bluesky",
  "name": "string",
  "handle": "string",
  "url": "string",
  "avatarUrl": "string",
  "accounts": [
    {
      "id": "string",
      "platform": "bluesky",
      "name": "string",
      "handle": "string",
      "url": "string"
    }
  ],
  "reach": {
    "followers": 0,
    "following": 0,
    "posts": 0
  },
  "profile": {
    "bio": "string",
    "company": "string",
    "location": "string",
    "website": "string",
    "email": "string",
    "links": [
      {
        "provider": "string",
        "url": "http://example.com"
      }
    ],
    "fetchedAt": "string"
  },
  "stats": {
    "mentions": 0,
    "relevant": 0,
    "sentiment": {
      "positive": 0,
      "neutral": 0,
      "negative": 0
    },
    "firstSeenAt": "string",
    "lastSeenAt": "string"
  },
  "annotations": {
    "tags": [
      "string"
    ],
    "notes": "string",
    "muted": true
  },
  "outreach": {
    "owner": {
      "id": "string",
      "name": "string",
      "email": "string"
    },
    "stage": "not_contacted",
    "lastContactedAt": "string"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Log an outreach activity POST

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.

Undo a merge POST

The account becomes its own person again.