# Callable Recipes - New call for recipe trigger
This trigger creates a job whenever it is called, in real-time. It can be called from another recipe or from another system as a API Platform REST endpoint.
API Platform must be enabled for your account before a callable recipe can be exposed as a REST endpoint. Check the Pricing and Plans page to find out more.
New call for recipe trigger
# Input fields
| Input field | Description |
|---|---|
| Name | Give this callable recipe trigger a name that describes its function. |
| Input schema | If this recipe expects JSON, use this to describe the expected JSON structure. |
| Response schema | If this recipe responds with JSON data, use this to describe the JSON structure. |
| Request type | Select the request data format. Defaults to JSON request body if left blank. |
| Response type | Select the response data format. Defaults to JSON response if left blank. |
# Output fields
Certain output fields are only available if the recipe is called as an API platform REST endpoint. More information can be found on the API platform documentation. <!--
| Default | Called as a REST endpoint | Output field | Description |
|---|---|---|---|
| ☑ | ☑ | Calling job ID | ID of the job in the parent recipe that made the call. |
| ☑ | ☑ | Calling recipe ID | Id of the parent recipe that made the call. |
| ☒ | ☑ | Calling IP address | IP address of the client calling this recipe as a REST endpoint. |
| ☒ | ☑ | Access profile | Contains ID, Name, and authentication method of the access profile used to perform the request. |
| ☒ | ☑ | API client | Contains API client ID and API client name used to perform the request. |
| ☒ | ☑ | JWT claims | Only available if a JWT token is used. Contains Audience, JWT ID, Issuer, and Expiration time, Not before and Issued at values of the JWT used to authenticate the request. |
| ☒ | Only if the request type is Raw request body | Content type | Content-type header from the incoming request. |
| ☒ | Only if the request type is Raw request body | Request body (raw) | Full raw request body. |
| ☑ | ☑ | Recipe input | This will contain the datapills as defined in the response schema. |
-->
| Output field | Description | ||
|---|---|---|---|
| Calling job ID | ID of the job in the parent recipe that made the call. | Calling recipe ID | ID of the parent recipe that made the call. |
| Only available if called as an API Platform REST endpoint | Calling IP address | IP address of the client calling this recipe as a REST endpoint. | |
| Access profile | Contains ID, name and authentication method of the access profile used to perform the request. | ||
| API client | Contains API client ID and API client name values to perform the request. | ||
| JWT claims | Only available a JWT token is used. Contains Audience, JWT ID, Issuer, and Expiration Time, Not before and Issued At values of the JWT used to authenticate the request. | ||
| Only if request type is Raw request body | Content type | Content-Type header value from the incoming request.
| |
| Request body (raw) | Full raw request body. | ||
| Recipe input | This output object will contain all the fields defined in Input schema. | ||
Didn’t find what you are looking for?