> 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/channels.md).

# Channels

## Make a channel primary

> Makes this the contact's primary channel of its type. The previous primary stays on the contact. Works on any active channel, including ones found by rvmpd research. A deactivated channel is refused with 409; activate it first.

```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}/channels/{channel_id}/primary":{"post":{"operationId":"contacts.channels.set_primary","summary":"Make a channel primary","description":"Makes this the contact's primary channel of its type. The previous primary stays on the contact. Works on any active channel, including ones found by rvmpd research. A deactivated channel is refused with 409; activate it first.","tags":["Channels"],"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":"channel_id","in":"path","required":true,"description":"The channel'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 channel's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}}}},"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"}}}},"409":{"description":"conflict","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"}}}}}}}}}
```

## Deactivate a channel

> Stops using a channel without deleting it. If it was the primary, the contact has no primary of that type until you choose one. Works on any channel, including ones found by rvmpd research. Deactivating a channel that is already inactive changes nothing.

```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}/channels/{channel_id}/deactivate":{"post":{"operationId":"contacts.channels.deactivate","summary":"Deactivate a channel","description":"Stops using a channel without deleting it. If it was the primary, the contact has no primary of that type until you choose one. Works on any channel, including ones found by rvmpd research. Deactivating a channel that is already inactive changes nothing.","tags":["Channels"],"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":"channel_id","in":"path","required":true,"description":"The channel'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 channel's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}}}},"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"}}}}}}}}}
```

## Activate a channel

> Starts using a deactivated channel again. It becomes the primary of its type only if the contact has no primary of that type. Activating a channel that is already active changes nothing.

```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}/channels/{channel_id}/activate":{"post":{"operationId":"contacts.channels.activate","summary":"Activate a channel","description":"Starts using a deactivated channel again. It becomes the primary of its type only if the contact has no primary of that type. Activating a channel that is already active changes nothing.","tags":["Channels"],"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":"channel_id","in":"path","required":true,"description":"The channel'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 channel's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}}}},"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 channel

> Permanently removes a channel your team or the API added. A channel found by rvmpd research cannot be deleted and is refused with 403; deactivate it instead. A channel still used elsewhere, such as in a conversation, is refused with 409; deactivate it instead.

```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}/channels/{channel_id}":{"delete":{"operationId":"contacts.channels.delete","summary":"Delete a channel","description":"Permanently removes a channel your team or the API added. A channel found by rvmpd research cannot be deleted and is refused with 403; deactivate it instead. A channel still used elsewhere, such as in a conversation, is refused with 409; deactivate it instead.","tags":["Channels"],"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":"channel_id","in":"path","required":true,"description":"The channel'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 channel's id."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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 channel 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"}}}},"409":{"description":"conflict","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 channel

> Changes a channel's value or label. Only channels your team or the API added can be changed. A channel found by rvmpd research is refused with 403. If the contact already has the new value on another channel, the request is refused with 409. A value that is not valid is refused with 400. To change which channel is primary, or to deactivate one, use those endpoints.

```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}/channels/{channel_id}":{"patch":{"operationId":"contacts.channels.update","summary":"Update a channel","description":"Changes a channel's value or label. Only channels your team or the API added can be changed. A channel found by rvmpd research is refused with 403. If the contact already has the new value on another channel, the request is refused with 409. A value that is not valid is refused with 400. To change which channel is primary, or to deactivate one, use those endpoints.","tags":["Channels"],"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":"channel_id","in":"path","required":true,"description":"The channel'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 channel's id."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"description":"The corrected email, phone number or LinkedIn URL.","type":"string","minLength":1,"maxLength":2048},"label":{"description":"A free text label. Send null to clear it.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"country":{"description":"Two-letter country code (ISO 3166), such as US or GB. Used only for phone numbers written without a country code. Defaults to US. A number that starts with + already names its country, so this is ignored for it.","type":"string","pattern":"^[A-Za-z]{2}$"}},"additionalProperties":false,"description":"Changes to a channel. Only channels your team or the API added can be changed. To change which channel is primary, or to deactivate one, use those endpoints."}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}}}},"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"}}}},"409":{"description":"conflict","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 a contact's channels

> Returns the contact's active channels, with each type's primary first. Set include\_inactive to true to also return deactivated channels, listed after the active ones.

```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}/channels":{"get":{"operationId":"contacts.channels.list","summary":"List a contact's channels","description":"Returns the contact's active channels, with each type's primary first. Set include_inactive to true to also return deactivated channels, listed after the active ones.","tags":["Channels"],"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":"include_inactive","in":"query","required":false,"description":"Set to true to include deactivated channels. They are listed after the active ones.","schema":{"description":"Set to true to include deactivated channels. They are listed after the active ones.","type":"string","enum":["true","false"]}}],"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":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}},"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"}}}},"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"}}}}}}}}}
```

## Add a channel to a contact

> Adds an email, phone number or LinkedIn profile to a contact. It becomes the primary of its type if the contact has none, unless is\_primary says otherwise. If the contact already has this value, the request is refused with 409, unless that channel was deactivated, in which case it is activated again. If another contact has the value, the request is refused with 409 and that contact is listed in error.duplicates. Send force set to true to add it anyway. A value that is not valid is refused with 422.

```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}/channels":{"post":{"operationId":"contacts.channels.create","summary":"Add a channel to a contact","description":"Adds an email, phone number or LinkedIn profile to a contact. It becomes the primary of its type if the contact has none, unless is_primary says otherwise. If the contact already has this value, the request is refused with 409, unless that channel was deactivated, in which case it is activated again. If another contact has the value, the request is refused with 409 and that contact is listed in error.duplicates. Send force set to true to add it anyway. A value that is not valid is refused with 422.","tags":["Channels"],"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."}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","minLength":1,"maxLength":2048,"description":"The email, phone number or LinkedIn URL."},"label":{"description":"A free text label, such as Work or Mobile.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"is_primary":{"description":"Make this the contact's primary channel of its type. When left out, it becomes primary only if the contact has no primary of that type.","type":"boolean"},"country":{"description":"Two-letter country code (ISO 3166), such as US or GB. Used only for phone numbers written without a country code. Defaults to US. A number that starts with + already names its country, so this is ignored for it.","type":"string","pattern":"^[A-Za-z]{2}$"},"force":{"description":"Add the channel even when another contact already has it. Without this, the request is refused with 409 and the other contacts are listed in error.duplicates.","type":"boolean"}},"required":["type","value"],"additionalProperties":false,"description":"A channel to add. If this contact already has the value, the request is refused with 409, unless the existing channel is deactivated, in which case it is activated again."}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"channel"},"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":["email","phone","linkedin"],"description":"The kind of channel: email, phone or linkedin."},"value":{"type":"string","description":"The value to show. Phone numbers are in international format, such as +16172531000. Emails and LinkedIn URLs are shown as entered."},"normalized":{"type":"string","description":"The form used to compare channels. Phones are in international format, emails are lowercase, and LinkedIn URLs are reduced to the host and path. Two channels of the same type are the same channel when this matches."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A free text label, such as Work or Mobile."},"is_primary":{"type":"boolean","description":"The contact's main channel of this type. A contact has at most one per type."},"active":{"type":"boolean","description":"False when the channel has been deactivated. Deactivated channels are kept but not used."},"source":{"type":"string","enum":["manual","api","enrichment","inbound"],"description":"Where the channel came from. manual: added by your team. api: added through the API. enrichment: found by rvmpd research. inbound: the contact wrote to you from it."},"editable":{"type":"boolean","description":"False for channels found by rvmpd research. Those can be made primary, deactivated or activated, but their value and label cannot be changed and they cannot be deleted."},"verified":{"type":"boolean","description":"True when the value has passed a verification check."},"verified_at":{"anyOf":[{"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)))$"},{"type":"null"}],"description":"When the last verification check passed."}},"required":["object","id","type","value","normalized","label","is_primary","active","source","editable","verified","verified_at"],"additionalProperties":false,"description":"A way to reach a contact."}}}},"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"}}}},"409":{"description":"conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable","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"}}}}}}}}}
```
