Skip to main content
POST
Create a Contact Reference

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contactId
integer<int32>

The identifier of the contact this record belongs to.

contactIndividualId
integer<int32> | null

The contact individual's identifier, if applicable.

referenceSource
string

The name of the external system that owns the reference identifier, for example Stripe, MailChimp, or Shopify.

referenceId
string

The identifier of the record in the reference source system.

Maximum string length: 80

Response

OK

A Contact Reference and its numeric Virtuous record id.

id
integer

The numeric id of this Contact Reference record.

contactId
integer

The id of the contact this reference belongs to.

contactIndividualId
integer | null

The associated contact individual's id, if any.

referenceSource
string

The external system that owns the reference identifier.

referenceId
string

The identifier of the record in the external system.

Maximum string length: 80
Last modified on October 1, 2026