Create a website

POST

https://api.modulards.com/api/public/v1/sites

POST

/api/public/v1/sites

curl -X POST https://api.modulards.com/api/public/v1/sites \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "My site",
  "provider": "wp",
  "team": 1,
  "uri": "https://example.com"
}'

201Create a website

{
  "data": {
    "attributes": {
      "connection_status": "pending",
      "connector_version": null,
      "core_version": null,
      "created_at": "2026-09-21T09:00:00.000000Z",
      "created_by": 42,
      "db_engine": null,
      "db_engine_version": null,
      "deleted_at": null,
      "display_host": "example.com",
      "ecommerce_engine": null,
      "ecommerce_version": null,
      "engine": null,
      "engine_version": null,
      "host": "example.com",
      "is_connected": false,
      "is_main_site": true,
      "is_multisite": false,
      "locale": null,
      "name": "My site",
      "path": null,
      "provider": "wp",
      "scheme": "https",
      "slug": "my-site",
      "synced_at": null,
      "timezone": null,
      "updated_at": "2026-09-21T09:00:00.000000Z",
      "uri": "https://example.com"
    },
    "id": "501",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/sites/501"
    },
    "type": "sites"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Adds a website to your organization, in the team you choose. The website starts unconnected: link it afterwards with “Create a Modular Connector download link” or “Retrieve a website’s manual connection credentials”.

Body

name (string, required): the website’s name, at most 60 characters.
provider (string, required): only wp (WordPress) is supported.
uri (string, required): the website’s address, at most 250 characters. It must be a public URL that Modular DS can reach and cannot belong to another website of your organization.
team (integer, required): the team the website joins.

Errors

422: the address is unreachable, private or already used by one of your websites.
404: the team is not one of yours, or your organization has used all the websites its plan includes and does not allow extra ones.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Request

This endpoint expects an object.

namestringOptional

providerstringOptional

teamdoubleOptional

uristringOptional

Response headers

LocationstringOptional

Response

201 - Website created

dataobjectOptional

jsonapiobjectOptional