> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.jambonz.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.jambonz.org/_mcp/server.

# Forward

The Forward hosted app allows you to connect a call to another carrier and control the destination number and the callerId

It can be used for both inbound and outbound calls, with outbounds calls you would initiate the call by making a REST API request to the [Create Call endpoint](https://docs.jambonz.org/reference/rest-call-control/calls/create-call)

# Requirements

Before setting up the hosted application you will need:

* A Jambonz Account,
* A SIP carrier configured in your jambonz account for connecting to the PSTN.
* A Phone number configured in your jambonz account for the above carrier.

# Get started

## Application

Login to your jambonz account, goto applications and click the + icon to create a new application.

Enter the name of your application, this can be anything, we suggest starting out with `forward-hosted`
Enter the Calling Webhook below, the same value should be automatically copied to the Call Status Webhook.

**`Calling Webhook`**

```txt Calling Webhook
https://forward.jambonz.app
```

When you enter the webhook some new fields will then appear beneath that as shown below, these are the Application Environment variables
for this hosted application. We'll go through how you should configure these next.

## Configuration

### carrier

The name of your SIP carrier in Jambonz that you want retell to use for forwarding the call via.

### number

The number to forward the call to, if not set it will use the to number of the incomming call leg.

### callerId

The callerId to set on the outgoing call, if not set it will use the from number of the incomming call leg.

# Help & support

If you experience any issues with using the Hosted application via Jambonz.cloud then please email [support@jambonz.org](mailto:support@jambonz.org) and include a call\_sid for an example call that shows the issue along with the date & time of the call.

Please also mention that you are using the Forward Hosted application.

You can view the code for this application on our [GitHub](https://github.com/jambonz/forward-hosted)