DataPublisher API v2.4

POST https://app.datapublisher.io/api/auth/registration-code/email
Content-Type: application/json

{ "email": "user@example.com" }

POST https://app.datapublisher.io/api/auth/register
Content-Type: application/json

{
  "username": "jdoe",
  "email": "user@example.com",
  "password": "at-least-8-characters",
  "registrationCode": "123456",
  "firstName": "John",
  "lastName": "Doe"
}

POST https://app.datapublisher.io/api/auth/login
Content-Type: application/json

{ "username": "jdoe", "password": "your-password" }

--> 200
{
  "message": "Login successful",
  "user": { "id": "...", "username": "jdoe", "email": "user@example.com", "firstName": "John", "lastName": "Doe" },
  "token": "eyJhbGciOi..."
}

Authorization: Bearer <token>

Token lifetime

Security note

{ "success": false, "error": "templateId is required", "message": "templateId is required" }

{ "success": false, "error": "Validation failed: 6-digit registration code required",
  "message": "Validation failed: 6-digit registration code required",
  "errors": [ { "msg": "...", "path": "registrationCode" } ] }

POST https://app.datapublisher.io/api/form-invitations
Authorization: Bearer <token>
Content-Type: application/json

{
  "formType": "event_registration",
  "operation": "create",
  "recipientEmail": "attendee@example.com",
  "recipientName": "Pat Attendee",
  "expiresInDays": 7,
  "sendEmail": true
}

--> 200
{
  "success": true,
  "inviteId": "b3f0...",
  "shareableUrl": "https://app.datapublisher.io/...",
  "expiresAt": "2026-09-26T14:00:00.000Z",
  "emailSent": true
}

cURL

# cURL
TOKEN=$(curl -s -X POST https://app.datapublisher.io/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"jdoe","password":"your-password"}' | jq -r .token)

curl -X POST https://app.datapublisher.io/api/form-invitations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"formType":"event_registration","operation":"create","recipientEmail":"attendee@example.com","sendEmail":true}'

JavaScript

// JavaScript (Node 18+)
const BASE = 'https://app.datapublisher.io/api';

async function api(path, { token, ...opts } = {}) {
  const res = await fetch(BASE + path, {
    ...opts,
    headers: { 'Content-Type': 'application/json', ...(token && { Authorization: `Bearer ${token}` }) },
  });
  const body = await res.json();
  if (!res.ok) throw new Error(body.message || body.error?.message || body.error || res.status);
  return body;
}

const { token } = await api('/auth/login', {
  method: 'POST', body: JSON.stringify({ username: 'jdoe', password: 'your-password' }),
});

const invite = await api('/form-invitations', {
  method: 'POST', token,
  body: JSON.stringify({ formType: 'event_registration', operation: 'create',
                         recipientEmail: 'attendee@example.com', expiresInDays: 7, sendEmail: true }),
});
console.log(invite.shareableUrl);

Python

# Python
import requests

BASE = 'https://app.datapublisher.io/api'

login = requests.post(f'{BASE}/auth/login', json={'username': 'jdoe', 'password': 'your-password'})
login.raise_for_status()
token = login.json()['token']

resp = requests.post(
    f'{BASE}/form-invitations',
    headers={'Authorization': f'Bearer {token}'},
    json={'formType': 'event_registration', 'operation': 'create',
          'recipientEmail': 'attendee@example.com', 'expiresInDays': 7, 'sendEmail': True},
)
resp.raise_for_status()
print(resp.json()['shareableUrl'])

Need help with the API?

• support@datapublisher.io
• Contact form
• Support Center