Update a saved wording

PATCH/v1/wordings/{id}

The channel stays as it was made (invalid_parameter_value, param channel). An archived wording is not changed (409 wording_archived).

Path parameters

idstringrequired

Body

Optional

namestring

at most 100 characters
messageobject

The wording a follow-up step's reminder sends. Left out: Parasend's standard reminder. preset picks Parasend's wording; custom holds your own, by language (Plan 1–3 and Enterprise). A field or language left out comes from the preset.
3 fields of message
- message.presetstring
  
  standard is the usual reminder; firmer and final are Parasend's stronger wordings.
  One of standard firmer final
  Default "standard"
- message.customobject
  
  Your own wording, by language (is, en); a field or a language left out comes from preset. Needs Plan 1–3 or Enterprise; otherwise refused with theme_knob_plan_gated.
  2 fields of custom
  - message.custom.isobject
    
    Plain text. An e-mail step takes subject, heading and text; an SMS step text only. Variables: {{recipient.name}}, {{recipient.first_name}}, {{sender.name}}, {{delivery.title}}, {{delivery.sent_on}}, {{delivery.expires_on}}, {{files.count}}; an SMS only the two dates. No links, e-mail addresses or phone numbers. An e-mail may hold the gender word {{recipient.gender: male | female | other}}.
    3 fields of is
    
    message.custom.is.subjectstring
    
    One line. Empty is the preset's.
    at most 150 characters
    
    message.custom.is.headingstring
    
    One line, in place of the reminder's heading.
    at most 150 characters
    
    message.custom.is.textstring
    
    A paragraph under the heading; for an SMS, between the sender's name and the link (3.5).
    at most 1500 characters
  - message.custom.enobject
    
    Plain text. An e-mail step takes subject, heading and text; an SMS step text only. Variables: {{recipient.name}}, {{recipient.first_name}}, {{sender.name}}, {{delivery.title}}, {{delivery.sent_on}}, {{delivery.expires_on}}, {{files.count}}; an SMS only the two dates. No links, e-mail addresses or phone numbers. An e-mail may hold the gender word {{recipient.gender: male | female | other}}.
    3 fields of en
    
    message.custom.en.subjectstring
    
    One line. Empty is the preset's.
    at most 150 characters
    
    message.custom.en.headingstring
    
    One line, in place of the reminder's heading.
    at most 150 characters
    
    message.custom.en.textstring
    
    A paragraph under the heading; for an SMS, between the sender's name and the link (3.5).
    at most 1500 characters
- message.sourceobject
  
  The saved wording and version this step's wording was loaded from. A record only: the step keeps its own copy. Not on a saved wording's own message.
  2 fields of source
  - message.source.wordingstringrequired
  - message.source.versionintegerrequired
    
    at least 1
is_defaultboolean

Notice wordings only: make this the first-notice wording for its channel.

Returns

200 application/json. The wording as it now is. See the Wording object.

Errors have one shape; see Errors for every code.

curl -X PATCH "https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6" \ -H "Authorization: Bearer $PARASEND_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Second reminder (firm)" }'

const res = await fetch('https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6', { method: 'PATCH', headers: { Authorization: `Bearer ${process.env.PARASEND_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ name: 'Second reminder (firm)', }), }); const data = await res.json();

import os, requests res = requests.patch( "https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6", headers={ "Authorization": f"Bearer {os.environ['PARASEND_KEY']}", }, json={ "name": "Second reminder (firm)", }, ) data = res.json()

using var http = new HttpClient(); var request = new HttpRequestMessage(HttpMethod.Patch, "https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY")); request.Content = new StringContent(""" { "name": "Second reminder (firm)" } """, Encoding.UTF8, "application/json"); var response = await http.SendAsync(request); var body = await response.Content.ReadAsStringAsync();

var json = """ { "name": "Second reminder (firm)" } """; var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6")) .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY")) .header("Content-Type", "application/json") .method("PATCH", HttpRequest.BodyPublishers.ofString(json)) .build(); var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client(); $response = $client->request('PATCH', 'https://api.parasend.com/v1/wordings/wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6', [ 'headers' => [ 'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'), ], 'json' => [ 'name' => 'Second reminder (firm)', ], ]); $data = json_decode($response->getBody(), true);

{ "id": "wrd_01M6R27T6WN5ZPHV4DA9SGQ3G6", "object": "wording", "name": "Second reminder (firm)", "use": "reminder", "channel": "email", "is_default": false, "version": 1, "version_id": "wrv_01M6R27T6WR1V5QFE0E3SKRHNW", "message": { "preset": "firmer" }, "created_at": "2026-11-06T09:15:05.820Z", "updated_at": "2026-11-06T09:15:05.829Z", "archived_at": null, "used_by": { "policies": 0, "policies_on_older_version": 0 } }