---
search:
  tags:
    - Bookmarks
    - POST
seo:
  description: >-
    Scrape the provided URL, archive the Markdown, and store the bookmark.
    Optionally assign it… Reference for the POST /v1/bookmarks endpoint in the
    Webfold API.
sidebar:
  label: Create and archive a bookmark
  badge: POST
title: Create and archive a bookmark
type: openapi-operation
---
Scrape the provided URL, archive the Markdown, and store the bookmark.
Optionally assign it to an existing collection.

`POST /v1/bookmarks`

**Request body** (`application/json`, required)

- `url` (string<uri>, required)
- `title` (string)
- `description` (string)
- `tags` (string[])
- `collection_id` (string) — Existing collection ID to assign the bookmark to

Request body example:

```json
{
  "url": "https://example.com",
  "title": "Example",
  "description": "An example page",
  "tags": [
    "demo"
  ],
  "collection_id": "col_1"
}
```

**Responses**

- `201` — Created bookmark
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `502` — Upstream service (arXiv, YouTube, web page) failed

Response example, 201:

```json
{
  "id": "bkm_1",
  "url": "https://example.com",
  "title": "Example",
  "description": "An example page",
  "tags": [
    "demo"
  ],
  "collection_id": "col_1",
  "owner": "dev",
  "archived_content": "string",
  "archived_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}
```