Create site

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 site

{
  "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"
  }
}

Registers a website (connection pending) in the acting organization and answers with the created resource. If uri already belongs to a website of this organization, that existing record is reused instead of creating a duplicate.

Body (JSON):

name (string, required, max 60).
provider (string, required) - only wp (WordPress) is currently supported.
uri (string, required, max 250, must be a reachable URL) - the website’s address; cannot already belong to another organization.
team (integer, required) - the team the website joins.

Answers 201 with the resource document and a Location header. The website starts unconnected (connection_status: "pending", is_connected: false): finish the connection with “Create connection plugin” or “Manual connection credentials”.

Requires a full-access token (read-only tokens answer 403). Validation failures answer 422 with a JSON:API errors document.

Registers a website (connection pending) in the acting organization and answers with the created resource. If `uri` already belongs to a website of this organization, that existing record is reused instead of creating a duplicate. **Body** (JSON): - `name` (string, required, max 60). - `provider` (string, required) - only `wp` (WordPress) is currently supported. - `uri` (string, required, max 250, must be a reachable URL) - the website's address; cannot already belong to another organization. - `team` (integer, required) - the team the website joins. Answers **201** with the resource document and a `Location` header. The website starts unconnected (`connection_status: "pending"`, `is_connected: false`): finish the connection with "Create connection plugin" or "Manual connection credentials". Requires a full-access token (read-only tokens answer 403). Validation failures answer 422 with a JSON:API `errors` document.

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