Inicio rápido
En 5 minutos: crea una clave de prueba y publica tu primer evento con una sola petición idempotente.
1. Crea una clave
- Entra en Mi empresa → Integraciones. Tienes que ser owner o admin de la empresa.
- Pon un nombre, marca Puede crear, editar y cancelar eventos y elige el modo Prueba.
- Copia la clave
rk_test_…. Se muestra una sola vez: guárdala como un secreto, en tu servidor, nunca en el navegador.
Lo que crea una clave de prueba no es público y se borra a los 7 días. Cuando todo funcione, crea una clave Real (rk_live_…) y repite.
bash
export REMOLOM_KEY=rk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx2. Publica un evento (upsert)
PUT /v1/events/external/:source/:externalId crea el evento si no existe (201) y lo actualiza si ya existe (200). Usa el id del evento en tu sistema como externalId: puedes repetir la petición sin crear duplicados.
bash
curl -X PUT https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05 \
-H "Authorization: Bearer $REMOLOM_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Concierto de jazz",
"categories": ["musica"],
"startsAt": "2026-12-05T21:00",
"venueName": "Sala Clamores",
"address": "Calle Alburquerque 14, Madrid",
"isFree": false,
"prices": [{ "name": "General", "priceCents": 1850 }],
"currency": "EUR",
"ticketUrl": "https://mi-web.com/entradas/jazz"
}'js
// Node 18+ (fetch nativo)
const res = await fetch('https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05', {
method: 'PUT',
headers: { Authorization: `Bearer ${process.env.REMOLOM_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
title: 'Concierto de jazz',
categories: ['musica'],
startsAt: '2026-12-05T21:00',
venueName: 'Sala Clamores',
address: 'Calle Alburquerque 14, Madrid',
isFree: false,
prices: [{ name: 'General', priceCents: 1850 }],
currency: 'EUR',
}),
})
const { event, error } = await res.json()
console.log(res.status, event?.id ?? error) // 201 la primera vez, 200 despuéspython
import os, requests
r = requests.put(
"https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05",
headers={"Authorization": f"Bearer {os.environ['REMOLOM_KEY']}"},
json={
"title": "Concierto de jazz",
"categories": ["musica"],
"startsAt": "2026-12-05T21:00",
"venueName": "Sala Clamores",
"address": "Calle Alburquerque 14, Madrid",
"isFree": False,
"prices": [{"name": "General", "priceCents": 1850}],
"currency": "EUR",
},
)
print(r.status_code, r.json())La respuesta es { "event": EventDTO } con el id de Remolom, las fechas en UTC y "test": true si usaste una clave de prueba.
3. Comprueba y cancela
bash
curl https://remolom.com/api/v1/events -H "Authorization: Bearer $REMOLOM_KEY"
curl -X DELETE https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05 \
-H "Authorization: Bearer $REMOLOM_KEY"DELETE cancela el evento, no lo borra. Un PUT posterior con el mismo externalId lo reactiva.
Siguientes pasos
- Revisa qué campos son obligatorios en Eventos.
- Recibe avisos de ventas con Webhooks.
- ¿Tu agenda ya está en iCal o CSV? Mira Sincronización de feeds: no hace falta programar.