Páginas de enlaces

Referencia de 17 endpoints generados desde mosend-wb-backend/src/modules/link-pages/link-pages.controller.ts.

Base path: /·17 endpoints·Source: mosend-wb-backend/src/modules/link-pages/link-pages.controller.ts

GET/organizations/:orgId/link-pages

bearer

Lista las páginas de enlaces (bio) de la organización.

Path params

orgIdstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/link-pages

bearer

Crea una página de enlaces.

Path params

orgIdstringrequerido

Body (JSON)

handlestringrequerido
Handle público único global. [a-z0-9_] 3-30.
displayNamestringrequerido
biostring
themeobject
Tema visual libre: { preset, accentColor, buttonStyle, ... }.

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"handle": "<handle>","displayName": "<displayName>","bio": "<bio>","theme": {}}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/organizations/:orgId/link-pages/archived

bearer

Lista las páginas archivadas (para restaurar).

Path params

orgIdstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/archived' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/organizations/:orgId/link-pages/:id

bearer

Detalle de una página de enlaces con sus items.

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/link-pages/:id

bearer

Actualiza perfil/tema/publicación de una página.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

handlestring
displayNamestring
biostring
themeobject
isPublishedboolean
coverMediaIdstring · uuid
id de MediaAsset (IMAGE) o null para quitar la portada.
avatarMediaIdstring · uuid
id de MediaAsset (IMAGE) o null para quitar la foto de perfil.

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"handle": "<handle>","displayName": "<displayName>","bio": "<bio>","theme": {},"isPublished": true,"coverMediaId": "00000000-0000-0000-0000-000000000000","avatarMediaId": "00000000-0000-0000-0000-000000000000"}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

DELETE/organizations/:orgId/link-pages/:id

bearer

Toggle archivado de la página (soft-delete reversible).

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/link-pages/:id/restore

bearer

Restaura una página archivada (la republica).

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/restore' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/link-pages/:id/cover

bearer

Sube la portada de la página (PNG/JPG/WebP, máx 8 MB).

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/cover' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/link-pages/:id/avatar

bearer

Sube la foto de perfil de la página (PNG/JPG/WebP, máx 8 MB).

Path params

orgIdstringrequerido
idstringrequerido

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/avatar' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

POST/organizations/:orgId/link-pages/:id/items

bearer

Agrega un enlace a la página.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

typestringrequerido
WHATSAPPEXTERNALCALLEMAILLOCATION
titlestringrequerido
subtitlestring
iconstring
configobjectrequerido
Config según type: WHATSAPP → { whatsAppLinkId } | { phoneNumberId, prefilledMessage? } EXTERNAL → { url } CALL → { phone } EMAIL → { email } LOCATION → { url }

Respuestas

curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/items' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"type": "WHATSAPP","title": "<title>","subtitle": "<subtitle>","icon": "<icon>","config": {}}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/link-pages/:id/items/reorder

bearer

Reordena los enlaces de la página.

Path params

orgIdstringrequerido
idstringrequerido

Body (JSON)

itemIdsstring[]requerido
Ids de los items en el nuevo orden.

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/items/reorder' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"itemIds": []}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

PATCH/organizations/:orgId/link-pages/:id/items/:itemId

bearer

Actualiza un enlace de la página.

Path params

orgIdstringrequerido
idstringrequerido
itemIdstringrequerido

Body (JSON)

titlestring
subtitlestring
iconstring
configobject
isActiveboolean

Respuestas

curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"title": "<title>","subtitle": "<subtitle>","icon": "<icon>","config": {},"isActive": true}'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

DELETE/organizations/:orgId/link-pages/:id/items/:itemId

bearer

Elimina un enlace de la página.

Path params

orgIdstringrequerido
idstringrequerido
itemIdstringrequerido

Respuestas

curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/link-pages/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/link-pages/p/:handle

público

Perfil público de una página publicada (JSON para SSR).

Path params

handlestringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/link-pages/p/<handle>'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/link-pages/p/:handle/cover

público

Sirve la portada de la página (stream público).

Path params

handlestringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/link-pages/p/<handle>/cover'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/link-pages/p/:handle/avatar

público

Sirve el avatar de la página (stream público).

Path params

handlestringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/link-pages/p/<handle>/avatar'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}

GET/link-pages/p/:handle/go/:itemId

público

Registra el click del enlace y redirige (302) al destino.

Path params

handlestringrequerido
itemIdstringrequerido

Respuestas

curl -X GET 'https://api.mosend.dev/link-pages/p/<handle>/go/00000000-0000-0000-0000-000000000000'

Response · 200

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}