Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt

Use this file to discover all available pages before exploring further.

Trigger Events

You can trigger events from client to SuprSend using track method. This can be used to trigger event-based workflows.
const resp = await suprSendClient.track(event: string, properties?: Dictionary)
Returns: Promise<ApiResponse>

Update user profile

Returns: Promise<ApiResponse>

Update user channels

Set user channel related information using following methods. Its recommended to use SuprSend’s Backend SDK’s to set user channels instead of Client SDK’s.
await suprSendClient.user.addEmail(email: string)
await suprSendClient.user.removeEmail(email: string)

// mobile should be as per E.164 standard: https://www.twilio.com/docs/glossary/what-e164
await suprSendClient.user.addSms(mobile: string)
await suprSendClient.user.removeSms(mobile: string)

// mobile should be as per E.164 standard
await suprSendClient.user.addWhatsapp(mobile: string)
await suprSendClient.user.removeWhatsapp(mobile: string)

Update user properties

This is the list of available user update methods:
This method will set users timezone. Timezone value should be in IANA timezone format.
await suprSendClient.user.setTimezone(timezone: string)
This method will set users preferred language. Language value should be in ISO 639-1 Alpha-2 format.
await suprSendClient.user.setPreferredLanguage(language: string)
Set is used to set the custom user property or properties. If already property is already present value will be replaced.
await suprSendClient.user.set(arg1: string | Dictionary, arg2?: unknown)
This method will remove user property. To remove channel pass $email, $sms, $whatsapp.
await suprSend.user.unset(arg: string | string[])
This method will add a value to the list for a given property.
await suprSendClient.user.append(arg1: string | Dictionary, arg2?: unknown)
This method will remove a value from the list for a given property.
await suprSendClient.user.remove(arg1: string | Dictionary, arg2?: unknown)
This method is similar to set method but values once set cannot be updated.
await suprSendClient.user.setOnce(arg1: string | Dictionary, arg2?: unknown)
Add the given amount to an existing user property. If the user does not already have the associated property, the amount will be added to zero. To reduce a property, provide a negative number as the value.
await suprSendClient.user.increment(arg1: string | Dictionary, arg2?: number)
Keys starting with ss_ or $ will be ignored.