# API-based Job

## Overview

API-based jobs allow users to build integrations with Soroban platform using simple HTTP requests. When user creates an API job they receive an HTTP endpoint that acts as a webhook for triggering the job. This means that user can assign any custom logic to when the smart contract function will invoked via the HTPP request. This action can be performed by:

* Using numerous automation and no-code platforms
* Via custom code written in any programming language

Skeeper provides an intuitive user interface for configuring smart contract invokations. It also handles execution and response handling.

## Tutorial

#### Create API-based job

In Skeeper UI go to [API-based jobs](https://app.skeeper.xyz/api-based-jobs) and press "Add Task". Populate the form with desired Soroban smart contract parameters.

<br>

<figure><img src="https://1504055522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsKaIpsr90svZIaSzsc3s%2Fuploads%2FKXOHB4dL0NcWILF67V4o%2FScreenshot%202024-06-04%20at%2013.47.21.png?alt=media&#x26;token=910535e5-fcee-41e3-b71e-1bbaeee97c9b" alt="API-based Job"><figcaption></figcaption></figure>

#### Retrieve JobId and Api key<br>

For API key click on the user icon in the top right corner.

For job id (not possible to retrieve yet)

<br>

<figure><img src="https://1504055522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsKaIpsr90svZIaSzsc3s%2Fuploads%2F5qGn1ec5Z6pSaXPMVzEO%2FScreenshot%202024-06-04%20at%2013.52.15.png?alt=media&#x26;token=70091f09-fa96-4d86-bb47-210e163f8adf" alt=""><figcaption></figcaption></figure>

#### Create an HTTP request

Make a POST request to <https://triggerjob-n7ps3nkq5a-uc.a.run.app&#x20>;

The body must be the following

\`\`\`

{

&#x20;   "jobId": "\[INSERT YOUR JOB ID]",

&#x20;   "apiKey": "\[INSERT YOUR API KEYS]"

}

\`\`\`

You will receive 200 status code in case of successful execution

<br>