Skip to main content

Basic Handbook Example

Generate a simple single-state employee handbook with basic policies.

Example Request​

mutation GenerateBasicHandbook($input: HandbookRequest!, $subscriptionType: SubscriptionType!) {
  generateHandbook(input: $input, subscriptionType: $subscriptionType) {
    content
    contentType
    subscriptionType
  }
}

Variables​

{
  "input": {
    "companyName": "Acme Corporation",
    "myState": "CA",
    "numberOfEmployees": 25,
    "multiState": false,
    "multiStateSelectedStates": [],
    "industry": "OTHER",
    "fullTimeHours": 40,
    "payPeriodFrequency": "WEEKLY",
    "performanceReviewPeriod": "EVERY_YEAR",
    "trialPeriod": true,
    "trialPeriodDays": 90,
    "paidHolidays": true,
    "paidHolidayNames": "New Year's Day, Memorial Day, Independence Day, Labor Day, Thanksgiving, Christmas",
    "vacationBenefits": true,
    "vacationBenefitEligibleMonths": 1,
    "vacationBenefitType": "ACCRUED_PTO",
    "vacationHoursEarned": 40,
    "vacationBenefitCarryover": true,
    "sickLeave": true,
    "sickHoursEarned": 24,
    "maximumSickLeave": 80,
    "healthInsurance": true,
    "directDeposit": true,
    "socialMediaPolicy": true,
    "progressiveDisciplinePolicy": true
  },
  "subscriptionType": "ONE_TIME"
}

Complete cURL Example​

curl -X POST https://handbooks.io/api/graphql-public \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -d '{
    "query": "mutation($input: HandbookRequest!, $subscriptionType: SubscriptionType!) { generateHandbook(input: $input, subscriptionType: $subscriptionType) { content contentType subscriptionType } }",
    "variables": {
      "input": {
        "companyName": "Acme Corporation",
        "myState": "CA",
        "numberOfEmployees": 25,
        "multiState": false,
        "multiStateSelectedStates": [],
        "industry": "PROFESSIONAL",
        "fullTimeHours": 40,
        "payPeriodFrequency": "weekly",
        "trialPeriod": true,
        "trialPeriodDays": 90,
        "paidHolidays": true,
        "vacationBenefits": true,
        "sickLeave": true,
        "healthInsurance": true,
        "directDeposit": true
      },
      "subscriptionType": "ONE_TIME"
    }
  }'

JavaScript Example​

const generateBasicHandbook = async (bearerToken) => {
  const response = await fetch('https://handbooks.io/api/graphql-public', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${bearerToken}`,
    },
    body: JSON.stringify({
      query: `
        mutation($input: HandbookRequest!, $subscriptionType: SubscriptionType!) {
          generateHandbook(input: $input, subscriptionType: $subscriptionType) {
            content
            contentType
            subscriptionType
          }
        }
      `,
      variables: {
        input: {
          companyName: 'Acme Corporation',
          myState: 'CA',
          numberOfEmployees: 25,
          multiState: false,
          multiStateSelectedStates: [],
          industry: 'OTHER',
          fullTimeHours: 40,
          payPeriodFrequency: 'WEEKLY',
          trialPeriod: true,
          trialPeriodDays: 90,
          paidHolidays: true,
          vacationBenefits: true,
          sickLeave: true,
          healthInsurance: true,
          directDeposit: true,
        },
        subscriptionType: 'ONE_TIME',
      },
    }),
  });

  const { data } = await response.json();
  return data.generateHandbook;
};

// Usage
const handbook = await generateBasicHandbook('your_bearer_token');
console.log(handbook.content);

Response​

{
  "data": {
    "generateHandbook": {
      "content": "<html><head><title>Employee Handbook - Acme Corporation</title></head><body>...</body></html>",
      "contentType": "text/html",
      "subscriptionType": "ONE_TIME"
    }
  }
}

What's Included​

This basic handbook includes:

  • State-Specific Compliance: California employment law requirements
  • Core Policies: Trial period, pay frequency, performance reviews
  • Basic Benefits: Paid holidays, vacation/PTO, sick leave, health insurance, direct deposit
  • Standard Policies: Social media policy, progressive discipline policy

Next Steps​