Developer Docs

npm install @prodigio-io/sdk

import { Prodigio } from '@prodigio-io/sdk';

// Call once at app root — badge is managed automatically
await Prodigio.init({ key: 'pk_live_your_key_here' });

// Paid tenants — paste the full snippet from your dashboard
await Prodigio.init({
  key: 'pk_live_your_key_here',
  badgeToken: 'your_signed_badge_token', // from Settings → Install snippet
});

<!-- Place this wherever you want the badge to appear — e.g. bottom of your careers page -->
<div data-prodigio-badge-anchor></div>

await Prodigio.init({
  key: 'pk_live_your_key_here',
  badgeContainer: '#careers-footer', // CSS selector for your container
});

import { Prodigio } from '@prodigio-io/sdk';

const prodigio = new Prodigio('pk_live_your_key_here');

// List active jobs
const jobs = await prodigio.jobs.list();

// Get a single job
const job = await prodigio.jobs.get('abc123');

// Upload a CV then submit an application
const cv = await prodigio.upload.cv(fileInput.files[0]);

const result = await prodigio.applications.submit({
  jobId: 'abc123',
  applicant: {
    fullName: 'Jane Smith',
    email: 'jane@example.com',
    phone: '+233 20 000 0000',
  },
  cv,
  coverLetter: 'I am excited to apply...',
});

console.log(result.id); // application ID

[
  {
    "id": "abc123",
    "title": "Frontend Engineer",
    "companyName": "Summer Health",
    "department": "Engineering",
    "location": "Accra, Ghana",
    "type": "full-time",
    "status": "active",
    "description": "<p>...</p>",
    "requirements": "<ul>...</ul>",
    "eligibilityCriteria": "<p>...</p>",
    "salaryRange": {
      "min": 3000,
      "max": 5000,
      "currency": "GHS",
      "period": "monthly"
    },
    "applicationDeadline": "2026-06-30T23:59:59.000Z",
    "createdAt": "2026-04-01T09:00:00.000Z",
    "updatedAt": "2026-04-01T09:00:00.000Z",
    "poweredBy": {
      "text": "Hiring powered by Prodigio",
      "url": "https://prodigio.io"
    }
  }
]

{
  "id": "abc123",
  "title": "Frontend Engineer",
  "companyName": "Summer Health",
  "department": "Engineering",
  "location": "Accra, Ghana",
  "type": "full-time",
  "status": "active",
  "description": "<p>...</p>",
  "requirements": "<ul>...</ul>",
  "eligibilityCriteria": "<p>...</p>",
  "salaryRange": {
    "min": 3000,
    "max": 5000,
    "currency": "GHS",
    "period": "monthly"
  },
  "applicationDeadline": "2026-06-30T23:59:59.000Z",
  "createdAt": "2026-04-01T09:00:00.000Z",
  "updatedAt": "2026-04-01T09:00:00.000Z",
  "poweredBy": {
    "text": "Hiring powered by Prodigio",
    "url": "https://prodigio.io"
  }
}

{
  "url": "https://storage.prodigio.io/files/abc123.pdf",
  "fileName": "john-doe-cv.pdf",
  "fileSize": 245760,
  "mimeType": "application/pdf",
  "path": "files/abc123.pdf"
}

{
  "url": "https://storage.prodigio.io/files/def456.png",
  "fileName": "screenshot.png",
  "fileSize": 204800,
  "mimeType": "image/png",
  "path": "files/def456.png"
}

{
  "jobId": "abc123",
  "applicant": {
    "fullName": "Jane Smith",
    "email": "jane@example.com",
    "phone": "+233 20 000 0000",
    "location": "Accra, Ghana",
    "linkedin": "https://linkedin.com/in/janesmith"
  },
  "cv": {
    "url": "https://storage.prodigio.io/files/xyz789.pdf",
    "fileName": "jane-smith-cv.pdf",
    "fileSize": 245760,
    "mimeType": "application/pdf"
  },
  "coverLetter": "I am excited to apply...",
  "achievements": [
    { "description": "Led a team of 5 engineers to ship the product on time", "attachment": null },
    { "description": "Reduced page load time by 40%", "attachment": null }
  ]
}

{
  "id": "app_xyz789",
  "message": "Application submitted successfully",
  "scoringError": null
}

const prodigio = new Prodigio('pk_live_your_key_here');

const result = await prodigio.interest.submit({
  name: 'Jane Smith',
  email: 'jane@example.com',
  phone: '+1 555 000 0000',
  areaOfInterest: 'Engineering',
  message: 'I would love to join your team.',
});

console.log(result.id);

import { Prodigio } from '@prodigio-io/sdk';

const API_KEY = 'pk_live_your_key_here';

// 1. Add to your HTML where the badge should appear:
//    <div data-prodigio-badge-anchor></div>

// 2. Initialise once at app root — badge is fully automatic
Prodigio.init({ key: API_KEY });

const prodigio = new Prodigio(API_KEY);

// 2. Fetch active jobs
async function getJobs() {
  return prodigio.jobs.list();
}

// 3. Fetch a single job
async function getJob(jobId) {
  return prodigio.jobs.get(jobId);
}

// 4. Upload a CV file (File object from <input type="file">)
async function uploadCV(file) {
  return prodigio.upload.cv(file); // { url, fileName, fileSize, mimeType, path }
}

// 5. Submit an application
async function submitApplication({ jobId, applicant, cvFile, coverLetter }) {
  const cv = await uploadCV(cvFile);
  return prodigio.applications.submit({ jobId, applicant, cv, coverLetter });
}