create_contact

Create a feedback contact. If you have a stable id from your own system, pass it as external_user_id. Returns 409 (CONFLICT) when external_user_id is already taken in this workspace — call identify_contact instead when you want upsert semantics.

required scope: read:write.

example prompts

• “create a contact for [email protected] with plan ‘Pro’ and mrr 14900 USD.”
• “add a contact for the user filing this support ticket so we can track their posts.”

input

field	type	required	notes
external_user_id	string (max 255 chars)	no
email	string (max 320 chars)	no
name	string (max 200 chars)	no
plan	string (max 100 chars)	no
mrr_cents	integer (0-100,000,000)	no
currency	string (regex)	no
metadata	object	no

notes

• mrr_cents and currency must be paired — set both or omit both.
• mrr_cents is capped at 100,000,000 ($1M).
• email is trimmed, lowercased, and capped at 320 characters.
• metadata may not contain more than 100 keys.

output

The created contact row.