Getting Started
Create a target and endpoint, send a request, and read the result in Activity.
Use this guide to create an endpoint and send the first request.
Purpose#
Use this workflow to:
- Sign in with session-cookie authentication.
- Create a relay target. A relay target is a saved connection to a system that receives the data.
- Create an endpoint. An endpoint is a URL that accepts relay requests.
- Send a request and read the outcome.
Before you start#
- Access to
/login, or to/signupif it is enabled. - A destination that you can reach: an email inbox, a webhook URL, Slack, Discord, Google Sheets, Microsoft Teams, PagerDuty, or Telegram.
- Signed-in user access.
Procedure#
1. Sign in#
- Open
Login. - Sign in with your email address and password, or with OAuth (Google, Apple, Microsoft) if it is enabled.
- If the app asks for an email confirmation, open the
Confirm emailpage and obey the instructions.
After you sign in, the navigation shows Endpoints, Relay targets, and Activity.
2. Create a relay target#
- Open
Relay targets. - Select
Create relay target. - In
Target type, select one card:Email,Webhook URL,Slack webhook,Discord webhook,Microsoft Teams,PagerDuty,Telegram, orGoogle Sheets. At first, the form has no selected type. - Enter the details for that type.
- Select
Create relay target.

These behaviors apply:
- A platform
Emailtarget starts asPending confirmation. You must confirm it. A custom SMTP email target starts asPending verificationuntilVerify connectionsucceeds. - A
Webhook URLtarget record contains the destination URL only. Configure the authentication, the custom headers, the HMAC signing, the HTTPS enforcement, the retries, and the other delivery behavior on each endpoint destination that uses the target. - A provider-specific target such as Google Sheets, PagerDuty, Telegram, or Microsoft Teams has its own fields.

3. Complete email target confirmation#
- Open the confirmation email.
- Open the confirmation link.
- Select
Confirm relay target. - Make sure that the platform email target shows
Availablein the target list.
4. Create an endpoint#
- Open
Endpointsand selectCreate endpoint. - In
Endpoint nameabove the tabs, enter the endpoint name. - In
Details, set the payload format. To change the accepted method, open theAdvancedgroup inDetails. A new webhook endpoint starts withPOSTandJSON. If the sender uses a different format, change these values. - In
Security, configure the inbound authentication, the captcha, the required headers, and the CORS origins as necessary. - In
Destinations, attach the relay targets and configure the endpoint-specific values such as the webhook retries. - Select
Create endpointto save the endpoint.
After the save, the endpoint details page opens and shows the notification Endpoint created. The details page shows these items:
- The endpoint URL.
- A
Next stepcard. It tells you to copy the URL, send a test request, and read the result in Activity. - For a webhook endpoint, the request snippets in the
Send to this endpoint: code samplespanel.
If you have no relay target yet, you can select Create relay target in the Destinations tab of the endpoint editor. The app opens the relay target form. After you save the relay target, the app returns you to the endpoint editor. For a custom SMTP email target, the edit page of the target opens first, so that you can select Verify connection. Then select Cancel to return to the endpoint editor. The editor does not keep the unsaved changes. If the editor has unsaved changes, the Unsaved changes dialog opens before the app leaves the editor. To keep the changes, save the endpoint first.
5. Send traffic to the endpoint URL#
- Open the endpoint details page or the endpoint edit page.
- Copy the endpoint URL (
/relay/{endpointId}). - Send a request that matches the configured method and payload format. For a webhook endpoint, you can copy a request snippet from the details page.

From Relay targets or from the relay target page, you can use Test reachability for a Webhook URL. This action sends an unauthenticated
request directly to that URL. It does not use the endpoint authentication, the headers, the signing, the HTTPS enforcement,
the retries, or the failover. To examine the complete delivery configuration, send traffic through the saved endpoint.
6. Read the result in Activity#
- Open
Activity. - In
Endpoint, select your endpoint. - Select the
Request logtab. - Read the outcomes and the error reasons.

Common final outcomes and failure outcomes:
Completed(ACCEPTED)Method Not Allowed(METHOD_NOT_ALLOWED)Auth Failed(AUTH_FAILED)Missing Headers(MISSING_REQUIRED_HEADERS)Validation Failed(FIELD_VALIDATION_FAILED)Payload Too Large(PAYLOAD_TOO_LARGE)Delivery Failed(DELIVERY_FAILED)
Expected result#
The setup is ready when these conditions are true:
- At least one relay target is
Available. A platform email target becomesAvailableafter you confirm it. A custom SMTP email target becomesAvailableafterVerify connectionsucceeds. - The endpoint is enabled and has one destination or more.
- The requests appear in Activity with the expected outcomes.
Common issues and fixes#
- The email target stays pending: send a new confirmation and open the most recent link.
- No traffic is visible: make sure that the sender uses the current endpoint URL.
- Rejections in Activity: make the sender method, content type, authentication, and headers agree with the endpoint configuration.
- Delivery failures: make sure that the target authentication, the URL, and the destination are correct.