HTTP

The HTTP Allowlist option lets you register and verify external HTTP or HTTPS endpoints that can securely interact with the platform. Once verified, these endpoints can be used for workflows, integrations, callbacks, and delivery reporting.

Steps to Add an HTTP Allowlist:

Navigate to Workspace Settings > Allowlist.

Click Add, the Add Allowlist screen opens.

Select the HTTP option from the available allowlist types.

Enter a Custom URL Name and URL for the Allowlist.

Verification Method

The Verification Method section determines how ownership or access to the provided URL is validated before the endpoint is allowlisted.

Three verification methods are available:

Verification Method	Description	Approval Time
DNS Verification	Verifies domain ownership using a DNS TXT record.	15 minutes to 24 hours
Web Token	Verifies the endpoint by validating a token returned from the URL response.	Less than 1 minute
Send for Verification	Submits the URL for manual review and approval by the Fyno team.	8 hours to 2 days

DNS Verification

Use DNS Verification when you have access to your domain’s DNS configuration. When you select DNS Verification, the system generates a verification TXT record to confirm domain ownership.

Steps

Select DNS Verification.

Copy the generated TXT record using the copy icon.

Add the TXT record to your domain's DNS configuration through your DNS provider.

Wait for the DNS changes to propagate.

Click Next to verify the domain ownership.

Once the record is detected, the verification is completed automatically.

Web Token Verification

Use Web Token Verification when the endpoint can read query parameters and return the token value in the response.

How It Works

When you select Web Token Verification, the platform sends a request to the specified endpoint with a fyno_token query parameter.

To complete verification, the endpoint must:

Read the token value from the request.
Return the same token value in the response.

Once the returned token matches the generated token, the endpoint is verified successfully.

Steps

Select Web Token Verification.

Optionally enter a custom token value.

Configure the endpoint to:

Read the fyno_token query parameter from the request.
Return the same token value in the response.

Click Next to initiate verification.

Once the token is validated, the endpoint is verified automatically.

Token Field

Field	Description
Token (Optional)	An optional custom alphanumeric token that is added as a `user_token` query parameter during verification. This helps identify that the verification request originated from Fyno and can be used for additional validation on the receiving endpoint.

Send for Verification

Use this option when DNS or Web Token verification cannot be configured.

How It Works

The provided URL is submitted for manual verification and approval by the Fyno team.

Steps

Select Send for Verification.

Enter a detailed description explaining (optional):

Why the URL needs to be allowlisted.
The intended use case.
Any relevant integration details.

Click Next to configure the endpoint and submit the request for verification.