# Create a sitemap entry

**Publié le** : 2026-05-08
**Catégorie** : SEO & Analytics

## `POST /sitemap/entries`

**Create a sitemap entry**

Adds a custom URL to the sitemap. Set `priority` (0.0-1.0),
`changefreq` (always, hourly, daily, weekly, monthly, yearly, never),
and `lastmod` date.

Required permissions: `sitemap.create`

### Request Body

Content-Type: `application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | Yes | Required. 1-2048 characters |
| `isExternal` | boolean | No | Boolean |
| `priority` | number | No | Between 0 and 1 |
| `changefreq` | "always" \| "hourly" \| "daily" \| "weekly" \| "monthly" \| "yearly" \| "never" | No | One of: always, hourly, daily, weekly, monthly, yearly, never |
| `lastModified` | string | No | Last modification datetime (ISO 8601) |
| `title` | string | No | Display title. Max 255 characters |


### Responses

| Status | Description |
| --- | --- |
| `201` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `422` | Validation error |


### Examples

```bash
curl -X POST https://api.lynkow.com/v1/sitemap/entries \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "/pricing",
    "priority": 0.8,
    "changefreq": "monthly",
    "title": "Pricing Page"
  }'
```

### Response Example

```json
{
  "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "url": "/pricing",
  "isExternal": false,
  "priority": 0.8,
  "changefreq": "monthly",
  "lastModified": null,
  "title": "Pricing Page",
  "createdAt": "2025-04-06T11:00:00.000Z",
  "updatedAt": "2025-04-06T11:00:00.000Z"
}
```

---