> ## Documentation Index
> Fetch the complete documentation index at: https://www.openrevenue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create project

> Creates a new project. The domain is automatically normalized — protocols and paths are stripped.

**name** `string` *required*

Display name for the project, e.g. "My Website".

**domain** `string` *required*

The site's domain, e.g. "mysite.com" or "[https://mysite.com](https://mysite.com)".

## Response

**id** `string`

Unique project identifier.

**name** `string`

Project display name.

**domain** `string`

Normalized domain with protocol and path removed.

**createdAt** `string`

ISO timestamp for when the project was created.

## Errors

| Status | Error | Description |
| - | - | - |
| `400` | `name and domain are required` | The JSON body is missing a required field. |
| `400` | `You already have a project for this domain` | The authenticated user already owns an active project for the normalized domain. |
| `400` | `{domain} is already added to another OpenRevenue account…` | Another account already has an active project for this domain. |
| `401` | `Invalid or missing API key` | The Authorization header is missing or the Bearer token is invalid. |
| `403` | `API key is read-only` | The key does not include the write scope. |

```javascript JavaScript theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
const res = await fetch("https://api.openrevenue.com/api/v1/projects", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${OPENREVENUE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "My Website", domain: "mysite.com" }),
})

const project = await res.json()
```

```bash cURL theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
curl -X POST https://api.openrevenue.com/api/v1/projects \
  -H "Authorization: Bearer openrevenue_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "My Website", "domain": "mysite.com" }'
```

```json 201 theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
{
  "id": "7f3a9d12-bc45-4e89-a012",
  "name": "My Website",
  "domain": "mysite.com",
  "createdAt": "2026-05-25T10:00:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.