Sent CreateContact
CertifiedCreate a Sent contact
Sent CreateContact
Create a Sent contact
Creates a contact with an idempotent Sent API mutation. Use sandbox mode while validating a flow.
type: io.kestra.plugin.sent.contacts.CreateContactExamples
Validate contact creation in sandbox mode
id: create_sent_contact_sandbox
namespace: company.messaging
inputs:
- id: phone
type: STRING
tasks:
- id: create_contact
type: io.kestra.plugin.sent.contacts.CreateContact
apiKey: "{{ secret('SENT_API_KEY') }}"
phoneNumber: "{{ inputs.phone }}"
defaultChannel: sent
sandbox: true
Properties
apiKey *string
Sent API key
API key sent in the x-api-key header. Store it as a Kestra secret.
phoneNumber *string
Phone number
Contact phone number in E.164 format.
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
Optional default delivery channel for the contact.
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.
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 creating 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.
