Policies

Generate a policy draft

Generate a policy draft from the supplied business facts and jurisdiction choice. The policy is saved, hosted at a public URL by default, and returned in the response. Review generated content before publication.

post/api/v1/policies

Request

  • Base URL: https://policyforge.co
  • URL: https://policyforge.co/api/v1/policies
  • Auth: HTTP bearer

Request body

type'privacy_policy' | 'terms_of_service' | 'cookie_policy' | 'refund' required

The type of policy to generate

business_type'e-commerce' | 'saas' | 'healthcare' | 'education' | 'financial' | 'real-estate' | 'non-profit' | 'consulting' | 'media' | 'other' required

Your business category

jurisdiction'gdpr' | 'ccpa' | 'pipeda' | 'us' | 'eu' | 'ca' | 'uk' | 'global' required

Primary legal jurisdiction for compliance

company_namestring required

Your company or organization name

contact_emailstring email required

Contact email for privacy/legal inquiries

website_urlstring uri

Your website URL

service_descriptionstring

Brief description of your service or product

data_collectionstring[]

Types of data your service collects

third_party_integrationsstring[]

Third-party services you integrate with

data_retentionstring

How long you retain user data

user_accountsboolean

Whether your service has user accounts

paymentsboolean

Whether your service processes payments

marketingboolean

Whether you send marketing communications

analyticsboolean

Whether you use analytics tracking

cookiesboolean

Whether your website uses cookies

children_databoolean

Whether your service collects data from children under 13

hosting_enabledboolean

Whether to host the policy at a public URL

Example request

{
  "company_name": "Acme Inc",
  "contact_email": "privacy@acme.com",
  "website_url": "https://acme.com",
  "service_description": "Project management SaaS platform for remote teams",
  "data_collection": [
    "name",
    "email",
    "usage_data",
    "payment_info"
  ],
  "third_party_integrations": [
    "Stripe",
    "Google Analytics",
    "Intercom"
  ],
  "data_retention": "2 years after account deletion"
}

Response

Policy created successfully

idstring uuid

Unique policy identifier

typestring

Policy type (privacy, terms, cookies, refund)

policy_typestring

Alias of type (same value), for naming consistency with the list endpoint

titlestring

Generated policy title

contentstring

Full policy content in HTML format

created_atstring date-time
status'draft' | 'published' | 'archived'

Policy publication status

hosting_enabledboolean
hosted_urlstring uri

Public URL where the policy is hosted (if hosting is enabled)

url_slugstring

URL slug for the hosted policy

metadataobject

Generation metadata (word count, compliance level, etc.)

Example response

{
  "title": "Privacy Policy - Acme Inc",
  "hosted_url": "https://policyforge.co/policy/privacy-acme-inc",
  "url_slug": "privacy-acme-inc"
}

Changes

No recorded changes to this operation across all 1 revision of this API.