# Create a new restaurant delivery via API

Creating a job in VROMO is the most common integration task. This allows you to create a job in VROMO for a specific restaurant using its Site ID. 

You will need:

1. A valid API key for a user in VROMO. You will find the API token for a particular group by logging into VROMO with an administrator role, clicking on your avatar in the top right corner of the screen, then selecting 'integrations'.\
   ![I](https://cdn2.hubspot.net/hubfs/5979392/Integrations%20link.png)
2. The Site ID for the restaurant for which you want to create deliveries in VROMO. You can look this up via API as well, but I suggest you log into VROMO and go to Sites to ensure that the Site has been set up correctly with a Group, Campaign, Auto-dispatch Policy and Template assigned. You can also grab the Site ID directly from the Site list to use in the API call to create the new job.

![](https://cdn2.hubspot.net/hubfs/5979392/image-3.png)

To create the job, POST to 

```
https://prod-api.spatula.io/v2/graph/role/sites/<siteID>/jobs?access_token=<access_token>
```

&#x20;**QUERY PARAMETERS**

| access\_token (required) | string |
| ------------------------ | ------ |

**REQUEST BODY SCHEMA:**&#x20;

| Field   | Field type                                                                                                 |
| ------- | ---------------------------------------------------------------------------------------------------------- |
| name    | <p>string</p><p>user defined job name</p>                                                                  |
| contact | object (Contact)                                                                                           |
| attr    | <p>object</p><p>key/value pairs of extra details to provide dispatch operators and/or delivery drivers</p> |
| tasks   | <p>object</p><p>pickup and dropoff details</p>                                                             |

For example:

```
[
  {
    "name": "My New Job",
    "contact": {
      "name": "Joe Bloggs",
      "phone": "+10123456789",
      "email": "joebloggs@gmail.com"
    },
    "tasks": [
      {
        "zone": {
          "name": "Deliver to Customer",
          "address": "123 Fake St",
          "coords": {
            "lat": -32.977559,
            "lon": 114.816393
          }
        },
        "timeframe": {
          "by": 1559838800000
        }
      }
    ],
    "attr": [
      {
        "key": "ORDER_ID",
        "value": "order12345"
      },
      {
        "key": "ASAP",
        "value": "true"
      }
    ]
  }
]
```

#### Responses

**200**&#x20;

job created

**400**&#x20;

invalid input, object invalid


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.vromo.io/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.