Log texts, emails, and calls with a prospect that happened outside HiringCenter (API keys scoped to a user only)
Log a Text, Email, or Call
Logs a text, email, or call with a prospect that happened outside HiringCenter, for example on a personal
phone or inbox. Nothing is sent. It is the same record a user makes with the Log Text, Log Email, and
Log Call buttons in a conversation, except that the API can also log inbound activity (something the
prospect sent or a call they made). direction defaults to outbound.
It is always saved in the user's personal thread with the prospect (Manual Log in the app, or Device Handoff when the user has it on), created when the user has none yet. It never goes in a HiringCenter Identity thread, because those only hold what went through an Identity's number or address.
This endpoint needs an API key scoped to a user. Every log belongs to a person, so the request must
act as one. A key created by connecting an AI tool (MCP) is scoped to the person who connected it; it
logs for them and needs no userId. An account-wide API key (made in Settings) is refused with 403.
The user must be an active member of the account and not View Only. Outbound texts and emails count in reports like messages the user sent. Users can change the date, time, and content, or delete it, from the conversation in the app.
Logging does not send anything, notify the prospect, start HiringCenter AI, or end a sequence, and it does not count toward plan usage.
Headers
X-Idempotency-KeystringOptional. Client-generated key that makes retries of this request safe. The first response for the key is stored for 24 hours and replayed for retries with the same method, path, query, and body. Reuse a key only when retrying the exact same request.
Example: idem_prospect_create_01HV6W0J7Y7A5Q3T4J6N8M2P
Request Body
prospectIdstring · requiredId of an existing prospect in your account.
typestring · enum · requiredWhat happened.
Enum values:textemailcall
directionstring · enumoutbound: the user contacted the prospect.inbound: the prospect contacted the user.Enum values:outboundinboundDefault: outbounddateWhen it happened, as Unix epoch milliseconds/seconds (integer), ISO 8601, or MM/DD/YYYY[ HH:mm[:ss]] (read like
dateonPOST /notes). Defaults to now. Past dates are fine; a time in the future is refused.contentstring · maxLength: 20000Plain text. Text: what the message said (required). Email: the email body (required). Call: notes about the call (optional).
subjectstring · maxLength: 500Emails only. Defaults to
Outbound emailorInbound email.callOutcomestring · enumCalls only. Optional.
Enum values:connectedvoicemailno-answeruserIdstringNot needed. A key scoped to a user always logs for that user, and a different
userIdreturns403.
Responses
Logged
successboolean · requireditemobject · requiredA text, email, or call logged with
POST /activities. It is a message in the user's personal thread with the prospect.