# Quickstart

{% stepper %}
{% step %}

### Generate an API Key

* To learn how to get an API Key, referer to [Authentication section](https://docs.erathos.com/api/concepts/authentication).
  {% endstep %}

{% step %}

### Get your Workspace ID

* Use the request in [List workspaces](https://docs.erathos.com/api-reference/workspaces#developers-workspaces).
* Copy the ID of the desired worspace.
  {% endstep %}

{% step %}

### Select one or more Jobs

* Use the request in [List Jobs](https://docs.erathos.com/api-reference/jobs#developers-workspaces-workspace_id-jobs).
* Copy the ID of jobs that will trigger an webhook event.
  {% endstep %}

{% step %}

### [Trigger a Job outside Erathos](https://docs.erathos.com/api/introduction/trigger-jobs-outside-erathos)

* Edit the [Example Json](https://docs.erathos.com/introduction#example):
  * Replace the `jobs` list with the Job IDs retrieved from the previous step.
  * Change the `url` with the endpoint that the webhook must send data.
  * Adapt the body and header accordingly.

### (or) [Trigger a job in Erathos](https://docs.erathos.com/api/introduction/trigger-jobs-in-erathos)

* Based on the [Run job request](https://docs.erathos.com/api-reference/jobs#developers-workspaces-workspace_id-jobs-_id-run), edit the url with the `workspace_id` and `job_id` obtained in the previous steps.
* Execute the request.
  {% endstep %}
  {% endstepper %}

***

You can also explore our collection of specific examples tailored for each tool. These examples provide practical insights and step-by-step instructions to help you get started effectively.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Airflow</td><td><a href="quickstart/airflow">airflow</a></td><td><a href="quickstart/airflow">airflow</a></td></tr><tr><td>Dbt Cloud</td><td><a href="quickstart/dbt-cloud">dbt-cloud</a></td><td><a href="quickstart/dbt-cloud">dbt-cloud</a></td></tr><tr><td>Erathos</td><td><a href="quickstart/erathos">erathos</a></td><td><a href="quickstart/erathos">erathos</a></td></tr><tr><td>Prefect</td><td><a href="quickstart/prefect">prefect</a></td><td><a href="quickstart/prefect">prefect</a></td></tr></tbody></table>