---
title: "open connection · RUAL Documentation"
description: "Opens a new postmark connection using the given API token."
canonical: https://docs.rual.nl/block-types/postmark/postmarkconnection_open
language: en
---

# open connection

This block is part of the [`postmark`](https://docs.rual.nl/block-types/postmark) group and was last modified in core [`v12.0.3`](https://docs.rual.nl/core-versions/120003).

Opens a new postmark connection using the given API token.

- flow `flow`

- token required `value`

- flow `flow`

- success `condition`

- error `value`

- connection `postmarkconnection`

A typical wiring for [open connection](https://docs.rual.nl/block-types/postmark/postmarkconnection_open): [get setting](https://docs.rual.nl/block-types/system%20settings/value_get_system_key_select) feeds the `value` pin; [branch](https://docs.rual.nl/block-types/flow/branch) feeds the `flow` pin; the `flow` out pin feeds [send email](https://docs.rual.nl/block-types/postmark/postmarkconnection_send_email); the `condition` out pin feeds [send email with template](https://docs.rual.nl/block-types/postmark/postmarkconnection_send_email_template).

![Studio canvas example for the open connection block: typical wiring for open connection.](https://docs.rual.nl/canvas-examples/postmarkconnection_open.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [send email](https://docs.rual.nl/block-types/postmark/postmarkconnection_send_email): this block feeds into it. sends a single email.

- [get setting](https://docs.rual.nl/block-types/system%20settings/value_get_system_key_select): feeds into this block. get a created system setting.

- [send email with template](https://docs.rual.nl/block-types/postmark/postmarkconnection_send_email_template): this block feeds into it. sends a single email with a template.

- [branch](https://docs.rual.nl/block-types/flow/branch): feeds into this block.

- [execute](https://docs.rual.nl/block-types/function%20execution/function_custom_execute): feeds into this block. Executes the given funcion and waits for it to be executed.

- [get document](https://docs.rual.nl/block-types/storage/function_get_document): feeds into this block. get a specific document based on the given GUID.

### Version history

Introduced in [`v12.0.3`](https://docs.rual.nl/core-versions/120003).

### Service documentation