Create households from unlinked CRM records
POST/v1/households/data/mappings/:service
Creates a household from each household record of the CRM in service that no household of your firm is linked to, up to 25 in one request, and links each household to its record. Send tags to use only the Wealthbox or Slant records with one of those tags; Redtail records are not filtered. created counts the records this request tried, including any whose household could not be created; remaining counts the records left for another request.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 429
The result, with the household data connections after it.
service is not wealthbox, redtail or slant, or tags is not an array of strings.
The access token is missing, invalid, or expired.
The access token does not have the write:household scope or the write:crm scope.
For slant: a Slant person of a household of this request has a record that a different contact holds, other than an archived contact of your firm. For an active contact of your firm, details.held gives its ID and name; remove that link, then send the request again. No household is created.
Too many requests. Wait the number of seconds in the Retry-After-per-person header (script-audience tokens) or the Retry-After header (other requests) before you retry. See Rate limit.