<Intro>

<EndpointHeader />

<Description>

Updates a contact property's fallback value, the only mutable field. The key and type cannot be changed after creation; create a new property instead.

</Description>

</Intro>

<Parameters in="path">

<Parameter name="property_id" type="string">

<Description>

ID of the contact property to update (`prp_`-prefixed).

</Description>

</Parameter>

</Parameters>

<Payload kind="request">

<Field name="fallback_value">

<Description>

Default used when a contact has no value for this property and the template does not supply an inline fallback. A string, number, or boolean matching the declared type (strings up to 500 characters); a value of another type returns a validation error. Set to null to remove the fallback.

</Description>

</Field>

</Payload>

<Payload kind="response">

<Field name="id" type="string" required>

<Description>

ID of the property (`prp_`-prefixed), accepted by every operation that takes a `property_id`.

</Description>

</Field>

<Field name="key" type="string" required>

<Description>

The property key, used as the key in contact data and as the template variable name in broadcasts. Lowercase letters, digits, and underscores, starting with a letter. Cannot be changed after creation.

</Description>

</Field>

<Field name="type" type="string" required>

<Description>

The value type every contact must use for this property. Cannot be changed after creation.

</Description>

<Description>

Possible values: `string`, `number`, `boolean`

</Description>

</Field>

<Field name="fallback_value">

<Description>

Default used when a contact has no value for this property and the template does not supply an inline fallback. A string, number, or boolean matching the declared type (strings up to 500 characters), or null when no fallback is set.

</Description>

</Field>

<Field name="archived" type="boolean">

<Description>

Whether the property is archived. An archived property is rejected in new contact writes and stops rendering in templates, but every value already stored on contacts is preserved. Reactivate it with unarchive.

</Description>

</Field>

<Field name="created_at" type="string" required />

<Field name="updated_at" type="string" required />

</Payload>