TEtenderly
Projects

Create a project

Changed on

Creates a project owned by the account in the path. The project slug is derived from the name and cannot be changed afterwards.

On organization accounts the creator and the organization owner are always added as project members. A project is open to every organization member by default (All members); send restricted: true to create a restricted project that only its explicit members can see, optionally seeding members.

Requires the create-project permission on the account.

post/v1/account/{accountSlug}/project

Request

Path parameters

accountSlugstring required

Account slug of the user

Request body

namestring required

Project name, 1 to 100 characters. The project slug is derived from the name and cannot be changed afterwards.

restrictedboolean

Organization accounts only. true creates a restricted project that is visible to its explicit members alone (Only invited members). Omitted or false creates a project open to every organization member (All members).

membersstring[]

Organization accounts only, and only together with restricted: true. Principal IDs of accepted organization members to add as project members. The creator and the organization owner are always added.

Example request

{
  "name": "Mainnet Monitoring",
  "members": [
    "2f6a3c4e-1b7d-4e0a-9c11-5d2e8a7b9f30"
  ]
}

Response

The project was created.

Example response

{
  "project": {
    "id": "d66fd37f-e2f8-46c3-b549-0160d60eec96",
    "name": "Mainnet Monitoring",
    "slug": "mainnet-monitoring",
    "owner_id": "49309f73-1d60-48fc-94b3-120fd9982381",
    "created_at": "2026-09-07T16:12:22.895718Z",
    "owner": {
      "id": "49309f73-1d60-48fc-94b3-120fd9982381",
      "username": "acme",
      "type": "organization"
    },
    "permissions": {
      "add_contract": true,
      "update_contract": true,
      "remove_contract": true,
      "create_alert": true,
      "update_alert": true,
      "remove_alert": true,
      "create_and_update_analytics": true,
      "manage_collaborators": true
    },
    "members": [
      {
        "id": "2f6a3c4e-1b7d-4e0a-9c11-5d2e8a7b9f30",
        "username": "jane",
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "jane@example.com",
        "accepted": true,
        "added_at": "2026-08-25T09:14:03.201Z"
      }
    ]
  }
}

Changes