---
title: "/people/{vanId}/canvassResponses/{canvassResponseId}"
method: PATCH
path: "/people/{vanId}/canvassResponses/{canvassResponseId}"
---

# /people/{vanId}/canvassResponses/{canvassResponseId}

`PATCH /people/{vanId}/canvassResponses/{canvassResponseId}`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/people/{vanId}/canvassResponses/{canvassResponseId}`
- Auth: HTTP basic

Use this endpoint to PATCH the SMS Opt-In value of a phone in the canvassContext body parameter of a canvass response. Attempting to PATCH other properties of a canvass response will result in a `400: Bad Request` error response.

## Path parameters

- `vanId` integer, required
- `canvassResponseId` integer, required

## Request body

- object
  - `canvassContext` object: Required; describes the context in which this Canvass Response was created.
    - `contactTypeId` integer: Optional; a valid [Contact Type ID](ref:canvassresponsescontacttypes)
    - `inputTypeId` integer: Optional; a valid [Input Type ID](ref:canvassresponsesinputtypes) (defaults to `11` → API)
    - `dateCanvassed` string, date: Optional; the ISO 8601 formatted date that the canvass attempt was made (defaults to today’s date)
    - `phoneId` integer: Optional; the identifier of the phone number that was called when canvassing this person. May result in a phone suppression in the event of certain kinds of Result Codes (e.g., Wrong Number.)
    - `skipMatching` boolean: Optional; if set to `true`, skips matching/de-duping of contact history. Defaults to a null value, aka `false`.
    - `omitActivistCodeContactHistory` boolean: Optional; if set to `true`, no contact history record will be created if `responses` contains only Activist Codes
    - `phone` object: Optional; describes the context of the phone number where a contact was attempted
      - `dialingPrefix` string: The country calling code of the number
      - `phoneNumber` string: Required when inputTypeId is 1 (Phone) or 37 (SMS); the phone number you are attempting - without calling code/dialing prefix
      - `smsOptInStatus` 'I' | 'O' | 'U': Optional; Must be one of three values: `I` (Opt-In), `O` (Opt-Out), `U` (Unknown). Please note: phone numbers that have been deactivated by the carrier will be marked with an SMS Opt In Status of "Unknown". This information is updated nightly based on information provided by cell phone carriers.
    - `campaignId` integer: Optional; a valid [Campaign ID](ref:campaigns). Required if `contentId` is also specified.
    - `contentId` integer: Optional; a valid Content ID. If specified, the Content's corresponding Campaign must be specified as `campaignId`.
    - `includeReferenceIdInResponse` boolean: Optional; When set to true, the response body will include a GUID corresponding to the newly created canvass response. This GUID can be used later at GET /people/{vanId}/canvassResponses to retrieve the associated canvassResponseId, which is necessary for patching canvass responses at PATCH /people/{vanId}/canvassResponses/{canvassResponseId}. By default, this parameter is false.

## Response `204`

204

- object

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/people/:vanId/canvassResponses/:canvassResponseId/patch.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)