Email
Inboxes
Marketing
- List contacts GET
- Create or update a contact POST
- Resend a contact's confirmation email POST
- Create a contact's preference links POST
- Import contacts in bulk POST
- Export contacts as CSV GET
- Retrieve a contact GET
- Update a contact PATCH
- Delete a contact DELETE
- Retrieve a contact's topics GET
- Update a contact's topics PATCH
- List contact properties GET
- Create a contact property POST
- Retrieve a contact property GET
- Update a contact property's fallback PATCH
- Delete a contact property DELETE
SMS
Sign
Verify
Forms
Scheduling
Hooks
Risk
Platform
Update a contact property's fallback
PATCH
/v1/contact_properties/{id}
Changes the value used when a contact has none for this property. Its key and type can't change.
bearerAuthheader
AuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
id*stringThe property's id.
Coss-Version?"2026-10-10"The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.
Value in
"2026-10-10"application/json- body
- body
- …
fallback*|||Used in templates for contacts without a value. null removes it.
The property.
application/json- response
- response
- …
object*"contact_property"Value in
"contact_property"id*stringkey*stringHow contacts and templates name it ({{{contact.<key>}}}). Can't change.
type*stringdate values are ISO 8601 strings.
Value in
"string""number""boolean""date"fallback*|||Used in templates for contacts without a value.
created_at*stringFormat
date-timeupdated_at*stringFormat
date-timeimport { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.email.contacts.properties.update("cprop_01k7c8m4q2f3e9v6t5r1n0p8yz", { fallback: "starter",});{ "object": "contact_property", "id": "cprop_01k7c8m4q2f3e9v6t5r1n0p8yz", "key": "plan", "type": "string", "fallback": "free", "created_at": "2026-10-10T12:00:00.000Z", "updated_at": "2026-10-10T12:00:00.000Z"}