> For the complete documentation index, see [llms.txt](https://docs.rvmpd.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rvmpd.com/touchpoints.md).

# Touchpoints

## List a contact's touchpoints

> Returns the touchpoints about one contact, most recent first by the date they happened. The same as listing touchpoints with contact\_id. A contact with no touchpoints, or one that does not exist, returns an empty list.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/contacts/{id}/touchpoints":{"get":{"operationId":"contacts.touchpoints.list","summary":"List a contact's touchpoints","description":"Returns the touchpoints about one contact, most recent first by the date they happened. The same as listing touchpoints with contact_id. A contact with no touchpoints, or one that does not exist, returns an empty list.","tags":["Touchpoints"],"parameters":[{"name":"id","in":"path","required":true,"description":"The contact's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The contact's id."}},{"name":"type","in":"query","required":false,"description":"Only return touchpoints of this type.","schema":{"description":"Only return touchpoints of this type.","type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"]}},{"name":"channel","in":"query","required":false,"description":"Only return touchpoints on this channel.","schema":{"description":"Only return touchpoints on this channel.","type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"]}},{"name":"source","in":"query","required":false,"description":"Only return touchpoints from this source.","schema":{"description":"Only return touchpoints from this source.","type":"string","enum":["manual","api","campaign","integration","system","import","task"]}},{"name":"search","in":"query","required":false,"description":"Only return touchpoints whose title, summary, content or external id contains this text.","schema":{"description":"Only return touchpoints whose title, summary, content or external id contains this text.","type":"string","minLength":1,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"How many touchpoints to return, from 1 to 100. Defaults to 25.","schema":{"default":25,"description":"How many touchpoints to return, from 1 to 100. Defaults to 25.","type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor value from the previous page. Treat it as opaque.","schema":{"description":"The next_cursor value from the previous page. Treat it as opaque.","type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. task_completed, task_skipped, form_submitted, imported_activity and conversation are recorded by rvmpd and cannot be written through the API."},"channel":{"anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, not when it was recorded. A touchpoint logged today about last week's call carries last week's date."},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short account of what happened."},"contact":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The contact this touchpoint is about."},{"type":"null"}],"description":"The contact this is about. Null when it is about a company."},"company":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The company this touchpoint is about."},{"type":"null"}],"description":"The company this is about. Null when it is about a contact."},"source":{"type":"string","enum":["manual","api","campaign","integration","system","import","task"],"description":"Where the record came from. manual: logged by your team. api: written through the API. campaign: sent by an rvmpd campaign. integration: synced from a connected system. system: recorded by rvmpd. import: from an imported file. task: from a completed cadence step."},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own id for this activity, as you sent it. rvmpd does not read it."},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A link to this activity in your own system, as you sent it."},"editable":{"type":"boolean","description":"False for touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends. Those cannot be changed or deleted through the API."},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["object","id","type","channel","date","title","summary","contact","company","source","external_id","external_url","editable","created_at","updated_at"],"additionalProperties":false,"description":"A touchpoint as it appears in a list. Retrieve the touchpoint to get its content."}},"has_more":{"type":"boolean","description":"True when there are more results after this page."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pass this as cursor to get the next page. Null when there are no more results."}},"required":["object","data","has_more","next_cursor"],"additionalProperties":false}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## List touchpoints

> Returns touchpoints in your organization, most recent first by the date they happened. Filter by contact\_id or company\_id to get one record's history. Content is left out of the list; retrieve a touchpoint to get it.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/touchpoints":{"get":{"operationId":"touchpoints.list","summary":"List touchpoints","description":"Returns touchpoints in your organization, most recent first by the date they happened. Filter by contact_id or company_id to get one record's history. Content is left out of the list; retrieve a touchpoint to get it.","tags":["Touchpoints"],"parameters":[{"name":"contact_id","in":"query","required":false,"description":"Only return touchpoints about this contact.","schema":{"description":"Only return touchpoints about this contact.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"company_id","in":"query","required":false,"description":"Only return touchpoints about this company.","schema":{"description":"Only return touchpoints about this company.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"type","in":"query","required":false,"description":"Only return touchpoints of this type.","schema":{"description":"Only return touchpoints of this type.","type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"]}},{"name":"channel","in":"query","required":false,"description":"Only return touchpoints on this channel.","schema":{"description":"Only return touchpoints on this channel.","type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"]}},{"name":"source","in":"query","required":false,"description":"Only return touchpoints from this source.","schema":{"description":"Only return touchpoints from this source.","type":"string","enum":["manual","api","campaign","integration","system","import","task"]}},{"name":"search","in":"query","required":false,"description":"Only return touchpoints whose title, summary, content or external id contains this text.","schema":{"description":"Only return touchpoints whose title, summary, content or external id contains this text.","type":"string","minLength":1,"maxLength":200}},{"name":"limit","in":"query","required":false,"description":"How many touchpoints to return, from 1 to 100. Defaults to 25.","schema":{"default":25,"description":"How many touchpoints to return, from 1 to 100. Defaults to 25.","type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor value from the previous page. Treat it as opaque.","schema":{"description":"The next_cursor value from the previous page. Treat it as opaque.","type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. task_completed, task_skipped, form_submitted, imported_activity and conversation are recorded by rvmpd and cannot be written through the API."},"channel":{"anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, not when it was recorded. A touchpoint logged today about last week's call carries last week's date."},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short account of what happened."},"contact":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The contact this touchpoint is about."},{"type":"null"}],"description":"The contact this is about. Null when it is about a company."},"company":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The company this touchpoint is about."},{"type":"null"}],"description":"The company this is about. Null when it is about a contact."},"source":{"type":"string","enum":["manual","api","campaign","integration","system","import","task"],"description":"Where the record came from. manual: logged by your team. api: written through the API. campaign: sent by an rvmpd campaign. integration: synced from a connected system. system: recorded by rvmpd. import: from an imported file. task: from a completed cadence step."},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own id for this activity, as you sent it. rvmpd does not read it."},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A link to this activity in your own system, as you sent it."},"editable":{"type":"boolean","description":"False for touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends. Those cannot be changed or deleted through the API."},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["object","id","type","channel","date","title","summary","contact","company","source","external_id","external_url","editable","created_at","updated_at"],"additionalProperties":false,"description":"A touchpoint as it appears in a list. Retrieve the touchpoint to get its content."}},"has_more":{"type":"boolean","description":"True when there are more results after this page."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pass this as cursor to get the next page. Null when there are no more results."}},"required":["object","data","has_more","next_cursor"],"additionalProperties":false}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Record a touchpoint

> Records something that happened with a contact or a company: a call, an email, a meeting, a note. Send contact\_id or company\_id, not both. The date is when it happened, not when you are recording it. Refused with 404 when the contact or company does not exist.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/touchpoints":{"post":{"operationId":"touchpoints.create","summary":"Record a touchpoint","description":"Records something that happened with a contact or a company: a call, an email, a meeting, a note. Send contact_id or company_id, not both. The date is when it happened, not when you are recording it. Refused with 404 when the contact or company does not exist.","tags":["Touchpoints"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contact_id":{"description":"The contact this is about. Send this or company_id, not both.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"company_id":{"description":"The company this is about. Send this or contact_id, not both.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. Use note for something written down, and other when nothing else fits."},"channel":{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, in ISO 8601, such as 2026-09-30T14:00:00Z. Not when you are recording it."},"title":{"type":"string","maxLength":500,"description":"A short title, such as Intro call."},"summary":{"type":"string","maxLength":10000,"description":"A short account of what happened."},"content":{"type":"string","maxLength":200000,"description":"The full text, such as the body of an email or the notes from a call."},"external_id":{"type":"string","minLength":1,"maxLength":500,"description":"Your own id for this activity. Stored and returned as sent."},"external_url":{"type":"string","maxLength":2048,"format":"uri","description":"A link to this activity in your own system. Must start with http or https."}},"required":["type","date"],"additionalProperties":false,"description":"A touchpoint to record, about exactly one contact or one company. Refused with 404 when that contact or company does not exist."}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. task_completed, task_skipped, form_submitted, imported_activity and conversation are recorded by rvmpd and cannot be written through the API."},"channel":{"anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, not when it was recorded. A touchpoint logged today about last week's call carries last week's date."},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short account of what happened."},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The full text, such as the body of an email or the notes from a call."},"contact":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The contact this touchpoint is about."},{"type":"null"}],"description":"The contact this is about. Null when it is about a company."},"company":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The company this touchpoint is about."},{"type":"null"}],"description":"The company this is about. Null when it is about a contact."},"source":{"type":"string","enum":["manual","api","campaign","integration","system","import","task"],"description":"Where the record came from. manual: logged by your team. api: written through the API. campaign: sent by an rvmpd campaign. integration: synced from a connected system. system: recorded by rvmpd. import: from an imported file. task: from a completed cadence step."},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own id for this activity, as you sent it. rvmpd does not read it."},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A link to this activity in your own system, as you sent it."},"editable":{"type":"boolean","description":"False for touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends. Those cannot be changed or deleted through the API."},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["object","id","type","channel","date","title","summary","content","contact","company","source","external_id","external_url","editable","created_at","updated_at"],"additionalProperties":false,"description":"One thing that happened with a contact or a company."}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Retrieve a touchpoint

> Returns one touchpoint with its full content.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/touchpoints/{id}":{"get":{"operationId":"touchpoints.retrieve","summary":"Retrieve a touchpoint","description":"Returns one touchpoint with its full content.","tags":["Touchpoints"],"parameters":[{"name":"id","in":"path","required":true,"description":"The touchpoint's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The touchpoint's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. task_completed, task_skipped, form_submitted, imported_activity and conversation are recorded by rvmpd and cannot be written through the API."},"channel":{"anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, not when it was recorded. A touchpoint logged today about last week's call carries last week's date."},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short account of what happened."},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The full text, such as the body of an email or the notes from a call."},"contact":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The contact this touchpoint is about."},{"type":"null"}],"description":"The contact this is about. Null when it is about a company."},"company":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The company this touchpoint is about."},{"type":"null"}],"description":"The company this is about. Null when it is about a contact."},"source":{"type":"string","enum":["manual","api","campaign","integration","system","import","task"],"description":"Where the record came from. manual: logged by your team. api: written through the API. campaign: sent by an rvmpd campaign. integration: synced from a connected system. system: recorded by rvmpd. import: from an imported file. task: from a completed cadence step."},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own id for this activity, as you sent it. rvmpd does not read it."},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A link to this activity in your own system, as you sent it."},"editable":{"type":"boolean","description":"False for touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends. Those cannot be changed or deleted through the API."},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["object","id","type","channel","date","title","summary","content","contact","company","source","external_id","external_url","editable","created_at","updated_at"],"additionalProperties":false,"description":"One thing that happened with a contact or a company."}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Delete a touchpoint

> Permanently removes a touchpoint your team or the API recorded. Touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends, are refused with 403.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/touchpoints/{id}":{"delete":{"operationId":"touchpoints.delete","summary":"Delete a touchpoint","description":"Permanently removes a touchpoint your team or the API recorded. Touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends, are refused with 403.","tags":["Touchpoints"],"parameters":[{"name":"id","in":"path","required":true,"description":"The touchpoint's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The touchpoint's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"deleted":{"type":"boolean","const":true}},"required":["object","id","deleted"],"additionalProperties":false,"description":"Confirms the touchpoint was deleted."}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Update a touchpoint

> Changes a touchpoint. Only the fields you send change, and null clears one. Send contact\_id or company\_id to move it to another contact or company. Touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends, are refused with 403.

```json
{"openapi":"3.1.0","info":{"title":"rvmpd API","version":"1.0.0"},"servers":[{"url":"https://api.rvmpd.com"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key. Create one in the dashboard under Settings, then API keys. Each key belongs to one organization, and every request made with it reads and writes that organization's data."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"description":"A broad category of the error. Use code for specific handling."},"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","not_found","conflict","unprocessable","rate_limited","internal_error"],"description":"invalid_request: the request is malformed or a field is invalid. unauthorized: the credentials are missing or wrong. forbidden: the credentials are valid but cannot do this. not_found: the record does not exist, or belongs to another organization. conflict: the request clashes with existing data, such as a duplicate. unprocessable: the request is well formed but a value cannot be used, such as a phone number that is not real. rate_limited: too many requests. Wait and retry. internal_error: something went wrong on our side. Retry, and contact support with the request_id if it persists."},"message":{"type":"string","description":"A sentence for a person to read. Do not parse it; it may change."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The request field the error is about, such as channels[1].value. Null when the error is not about one field."},"request_id":{"type":"string","description":"Identifies this request. Include it when contacting support."},"duplicates":{"description":"Only on a 409 conflict from creating a contact or adding a channel. Lists the existing records that may be duplicates.","type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing contact's id."},"name":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The existing contact's job title."},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"relationship":{"type":"string","description":"What the contact is at this company, such as employee or owner."},"is_primary":{"type":"boolean","description":"True for the company the contact works at."}},"required":["id","name","relationship","is_primary"],"additionalProperties":false},"description":"The companies the existing contact is connected to, to help tell people apart."}},"required":["object","id","name","title","confidence","match","companies"],"additionalProperties":false,"description":"An existing contact that may be the same person."},"description":"Existing contacts that may be the same person. Exact matches come first."},"companies":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The existing company's id. To connect a contact to it, send it as company.id."},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"string","enum":["exact","possible"],"description":"exact: the record shares an identifier, email, phone, LinkedIn profile or company domain with your request. possible: only the name is the same or similar."},"match":{"type":"object","properties":{"on":{"type":"string","enum":["identifier","email","phone","linkedin","domain","name"],"description":"What matched: an identifier such as a CRD, a channel, a company domain, or a name."},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The value that matched, such as the email address or the identifier with its scheme. Null when the match is on a name."}},"required":["on","value"],"additionalProperties":false,"description":"Why this record was matched."}},"required":["object","id","name","domain","confidence","match"],"additionalProperties":false,"description":"An existing company that may be the same company."},"description":"Existing companies that may be the same company. Only present when the request would create a company."}},"required":["contacts","companies"],"additionalProperties":false}},"required":["type","code","message","param","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"Every error response has this shape."}}},"paths":{"/v1/touchpoints/{id}":{"patch":{"operationId":"touchpoints.update","summary":"Update a touchpoint","description":"Changes a touchpoint. Only the fields you send change, and null clears one. Send contact_id or company_id to move it to another contact or company. Touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends, are refused with 403.","tags":["Touchpoints"],"parameters":[{"name":"id","in":"path","required":true,"description":"The touchpoint's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The touchpoint's id."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. Use note for something written down, and other when nothing else fits."},"channel":{"description":"Send null to clear it.","anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"description":"When it happened. Cannot be cleared.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"title":{"description":"Send null to clear it.","anyOf":[{"type":"string","maxLength":500,"description":"A short title, such as Intro call."},{"type":"null"}]},"summary":{"description":"Send null to clear it.","anyOf":[{"type":"string","maxLength":10000,"description":"A short account of what happened."},{"type":"null"}]},"content":{"description":"Send null to clear it.","anyOf":[{"type":"string","maxLength":200000,"description":"The full text, such as the body of an email or the notes from a call."},{"type":"null"}]},"external_url":{"description":"Send null to clear it.","anyOf":[{"type":"string","maxLength":2048,"format":"uri","description":"A link to this activity in your own system. Must start with http or https."},{"type":"null"}]},"contact_id":{"description":"Move the touchpoint to this contact. Send this or company_id, not both.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"company_id":{"description":"Move the touchpoint to this company. Send this or contact_id, not both.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"additionalProperties":false,"description":"Changes to a touchpoint. Only fields you send change; send null to clear one. Touchpoints recorded by rvmpd are refused with 403."}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"touchpoint"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["note","email_sent","email_received","call_completed","call_missed","voicemail_left","meeting_booked","meeting_held","meeting_cancelled","meeting_no_show","linkedin_connect","linkedin_message","linkedin_view_profile","other","task_completed","task_skipped","form_submitted","imported_activity","conversation"],"description":"What happened. The type carries direction and outcome: email_sent and email_received, call_completed and call_missed, meeting_held and meeting_no_show. task_completed, task_skipped, form_submitted, imported_activity and conversation are recorded by rvmpd and cannot be written through the API."},"channel":{"anyOf":[{"type":"string","enum":["email","phone","meeting","linkedin","sms","note","task","form","other"],"description":"How it happened: the medium, separate from what happened."},{"type":"null"}]},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When it happened, not when it was recorded. A touchpoint logged today about last week's call carries last week's date."},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short account of what happened."},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The full text, such as the body of an email or the notes from a call."},"contact":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"contact"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The contact this touchpoint is about."},{"type":"null"}],"description":"The contact this is about. Null when it is about a company."},"company":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","const":"company"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["object","id","name"],"additionalProperties":false,"description":"The company this touchpoint is about."},{"type":"null"}],"description":"The company this is about. Null when it is about a contact."},"source":{"type":"string","enum":["manual","api","campaign","integration","system","import","task"],"description":"Where the record came from. manual: logged by your team. api: written through the API. campaign: sent by an rvmpd campaign. integration: synced from a connected system. system: recorded by rvmpd. import: from an imported file. task: from a completed cadence step."},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own id for this activity, as you sent it. rvmpd does not read it."},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A link to this activity in your own system, as you sent it."},"editable":{"type":"boolean","description":"False for touchpoints recorded by rvmpd, such as form submissions, conversations and campaign sends. Those cannot be changed or deleted through the API."},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["object","id","type","channel","date","title","summary","content","contact","company","source","external_id","external_url","editable","created_at","updated_at"],"additionalProperties":false,"description":"One thing that happened with a contact or a company."}}}},"400":{"description":"invalid_request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
