Skip to main content

Instantiation

See Authentication for both approaches. Use IEmailLibrary for dependency injection.

Building a message

Attachments

Send a message

The SendMessageResponse includes:

Send bulk messages

Send up to 50 messages in a single API call. Each message gets its own tracking ID.

Check delivery status

Common DeliveryStatus values: delivered, delivered via secure portal, soft bounced, hard bounced, processing. Opens are reported separately in OpenedStatus, which is "unopened" until the message is opened.

Scheduled send

Schedule a message for future delivery, check its status, reschedule, or cancel it.

Schedule a message

scheduledAt must be an ISO 8601 UTC datetime string in the future and within 30 days.

Get scheduled message status

Reschedule a message

Cancel a scheduled message

Dynamic templates

Templates use Handlebars syntax ({{variable_name}}).

Create a template

The API responds with the template itself, which doesn’t match DynamicTemplateResponse, so in SDK v1.3.1 through v2.0.0 the returned object’s properties are null even though the template was created. The same applies to UpdateDynamicTemplate.

List templates

In SDK v1.3.1 through v2.0.0, ListDynamicTemplates expects a JSON array, but the API returns an object with a templates array, so the call throws JsonSerializationException. The List dynamic templates API reference shows the response.

Get a template

Update a template

Delete a template

Send a templated message

Error handling

A non-2xx HTTP response throws PauboxApiException, which exposes StatusCode and the raw response Body. A 2xx response whose body contains API errors throws SystemException with the raw JSON response as its message: