# Creating Projects via API

{% hint style="warning" %}
Unlike the previous versions of Microreact, creating project via API requires an [API access token](https://docs.microreact.org/api/access-tokens).
{% endhint %}

## Create Project

<mark style="color:green;">`POST`</mark> `https://microreact.org/api/projects/create/`

#### Query Parameters

| Name   | Type   | Description                                                        |
| ------ | ------ | ------------------------------------------------------------------ |
| access | String | When set to `private`, the created project will be set to private. |

#### Headers

| Name         | Type   | Description                                                         |
| ------------ | ------ | ------------------------------------------------------------------- |
| Content-Type | String | <p>Should be</p><p><code>application/json; charset=utf-8</code></p> |
| Access-Token | String | An API access token.                                                |

#### Request Body

| Name | Type   | Description                                                       |
| ---- | ------ | ----------------------------------------------------------------- |
|      | Object | <p>A valid</p><p><code>.microreact</code></p><p>JSON document</p> |

#### Response

{% tabs %}
{% tab title="Status code 200" %}
A JSON document which include the ID and the URL of the project.

```javascript
{
  "id": "gb7RzDg87aJK2yGAqQiaiu",
  "url": "https://microreact.org/project/gb7RzDg87aJK2yGAqQiaiu"
}
```

{% endtab %}
{% endtabs %}

### Example

{% tabs %}
{% tab title="cURL + Bash" %}

```bash
curl \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "Access-Token: eyJhbGciOiJIUzUxMiJ9..." \
  --data "@project.microreact" \
  https://microreact.org/api/projects/create
```

{% endtab %}
{% endtabs %}