Sent UpdateContact
CertifiedUpdate a Sent contact
Sent UpdateContact
Update a Sent contact
Updates the contact's default channel and/or opt-out state with an idempotency key.
type: io.kestra.plugin.sent.contacts.UpdateContactExamples
Validate an opt-out update in sandbox mode
id: update_sent_contact_sandbox
namespace: company.messaging
inputs:
- id: contact_id
type: STRING
tasks:
- id: update_contact
type: io.kestra.plugin.sent.contacts.UpdateContact
apiKey: "{{ secret('SENT_API_KEY') }}"
contactId: "{{ inputs.contact_id }}"
optOut: true
sandbox: true
Properties
apiKey *string
Sent API key
API key sent in the x-api-key header. Store it as a Kestra secret.
contactId *string
Contact ID
Sent contact UUID.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://api.sent.dm/v3Sent API base URL
Sent API v3 origin. Keep the default in production. Custom HTTPS origins are intended for controlled proxies; plain HTTP is accepted only for loopback test servers.
connectTimeout string
PT10SConnection timeout
Maximum time allowed to establish the Sent API connection.
defaultChannel string
Default channel
New default channel, if it should change.
idempotencyKey string
sent_{{ taskrun.id }}Idempotency key
Stable key that makes retries safe. The default is unique and stable for this task run.
initialRetryInterval string
PT1SInitial retry interval
Initial exponential-backoff delay for retry-safe transient failures.
maxAttempts integerstring
3Maximum request attempts
Total attempts for retry-safe calls. GET requests are retry-safe; mutations retry only when an idempotency key is present.
maxRetryInterval string
PT30SMaximum retry interval
Upper bound for exponential backoff and provider Retry-After delays.
optOut booleanstring
Opt out
New contact opt-out state, if it should change.
profileId string
Sender Profile ID
Optional Sender Profile UUID for x-profile-id scoping with an organization API key. Profile API keys must leave this unset.
readTimeout string
PT30SRead timeout
Maximum idle time while reading a Sent API response.
sandbox booleanstring
falseSandbox mode
When true, Sent validates the mutation without changing production data.
Outputs
data object
Sent response data
Provider resource data from the successful v3 response envelope.
idempotentReplayed boolean
Idempotent replay
Whether Sent returned a cached response for a previously completed idempotent request.
requestId string
Sent request ID
Provider request identifier for support and correlation.
sandbox boolean
Sandbox response
Whether Sent confirmed that the mutation was simulated without side effects.
