paperform_create_coupon

WRITE: create a coupon code on a form, with a fixed discountAmount or a discountPercentage (not both), an optional target (price or subscription) and expiry. Respondents can use it at checkout as soon as it is enabled. Undo: paperform_update_coupon with enabled=false. Paperform: POST /forms/{slug_or_id}/coupons.

destructive

Argument	Type	Description
code*	string	The new coupon code, e.g. SPRING20.
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
target	string	What the discount applies to: the one-off price or a subscription.
enabled	boolean	Whether respondents can use the coupon.
expiresAt	any	When the coupon expires (ISO 8601 with a timezone), or null for no expiry.
discountAmount	number	A fixed discount, in the form's currency (e.g. 10 = 10.00).
discountPercentage	number	A percentage discount, 0-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The new coupon code, e.g. SPRING20."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "target": {
      "enum": [
        "price",
        "subscription"
      ],
      "type": "string",
      "description": "What the discount applies to: the one-off price or a subscription."
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether respondents can use the coupon."
    },
    "expiresAt": {
      "anyOf": [
        {
          "type": "string",
          "description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z (sent to Paperform in UTC)."
        },
        {
          "type": "null"
        }
      ],
      "description": "When the coupon expires (ISO 8601 with a timezone), or null for no expiry."
    },
    "discountAmount": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0,
      "description": "A fixed discount, in the form's currency (e.g. 10 = 10.00)."
    },
    "discountPercentage": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "A percentage discount, 0-100."
    }
  }
}

paperform_get_coupon

Fetch one coupon on a form by code. Paperform: GET /forms/{slug_or_id}/coupons/{code}.

read-only

Argument	Type	Description
code*	string	The coupon code, e.g. DISCOUNT1.
form*	string	The form's slug, custom slug or id (from paperform_list_forms).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The coupon code, e.g. DISCOUNT1."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    }
  }
}

paperform_get_form

Fetch one form by slug, custom slug or id: title, description, url, live flag, tags, submission_count, space and dates. Paperform: GET /forms/{slug_or_id}.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form"
  ],
  "properties": {
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    }
  }
}

paperform_get_papersign_document

Fetch one Papersign document by id: status, signers and their progress, variables, folder, space and dates. Needs the Papersign API. Paperform: GET /papersign/documents/{id}.

read-only

Argument	Type	Description
document_id*	string	The Papersign document id (from paperform_list_papersign_documents).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "document_id"
  ],
  "properties": {
    "document_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The Papersign document id (from paperform_list_papersign_documents)."
    }
  }
}

paperform_get_partial_submission

Fetch one partial submission by id, with the answers given so far. It may have been completed since (submitted_at set); submitted_at null means abandoned. Paperform: GET /partial-submissions/{id}.

read-only

Argument	Type	Description
partial_submission_id*	string	The partial submission id (from paperform_list_partial_submissions).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "partial_submission_id"
  ],
  "properties": {
    "partial_submission_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The partial submission id (from paperform_list_partial_submissions)."
    }
  }
}

paperform_get_product

Fetch one product on a form by SKU: price, quantity in stock, sold count, limits. Paperform: GET /forms/{slug_or_id}/products/{sku}.

read-only

Argument	Type	Description
sku*	string	The product SKU (from paperform_list_products).
form*	string	The form's slug, custom slug or id (from paperform_list_forms).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The product SKU (from paperform_list_products)."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    }
  }
}

paperform_get_signed_document_url

Get a download link for a completed (fully signed) Papersign document as a PDF. A fresh link is made on each call and is valid for one week (expires_at_utc). Needs the Papersign API. Paperform: GET /papersign/documents/{id}/completed-document-url.

read-only

Argument	Type	Description
document_id*	string	The id of a completed Papersign document.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "document_id"
  ],
  "properties": {
    "document_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The id of a completed Papersign document."
    }
  }
}

paperform_get_submission

Fetch one submission by id, with every answer, device info, payment charge and PDFs. Paperform: GET /submissions/{id}.

read-only

Argument	Type	Description
submission_id*	string	The submission id (from paperform_list_submissions).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "submission_id"
  ],
  "properties": {
    "submission_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The submission id (from paperform_list_submissions)."
    }
  }
}

paperform_list_coupons

List a form's coupon codes (code, enabled, target, discountAmount or discountPercentage, expiresAt). Paperform: GET /forms/{slug_or_id}/coupons.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form"
  ],
  "properties": {
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    }
  }
}

paperform_list_form_fields

List a form's questions (key, title, type, required, custom_key, description, options). The field keys are the keys of a submission's `data` object, so read this to interpret answers. Paperform: GET /forms/{slug_or_id}/fields.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
search	string	Only fields whose name matches this text.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form"
  ],
  "properties": {
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only fields whose name matches this text."
    }
  }
}

paperform_list_forms

List the forms in the Paperform account (id, slug, custom_slug, title, url, live, tags, submission_count, space_id, dates), newest first. Search by title, or also by slug/custom_slug with search_fields. Start here to find the slug or id the other tools need. Paperform: GET /forms.

read-only

Argument	Type	Description
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
search	string	Text to match (partial, case-insensitive) — the form title unless search_fields says otherwise.
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
before_id	string	Cursor: only results before this id.
after_date	string	Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set.
before_date	string	Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set.

paperform_list_papersign_documents

List Papersign e-signature documents (id, name, status, folder, space, signers, variables, source form/submission, sent/completed dates), filtered by name, status, folder, space or the Paperform submission that created them. Needs the Papersign API. Paperform: GET /papersign/documents.

read-only

Argument	Type	Description
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
search	string	Only documents whose name matches this text.
status	array	Only documents in these statuses.
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
space_id	string	Only documents anywhere in this space (from paperform_list_papersign_spaces).
before_id	string	Cursor: only results before this id.

paperform_list_papersign_folders

List Papersign folders (id, name, parent_id, space_id), optionally inside one space or folder. Needs the Papersign API. Paperform: GET /papersign/folders.

read-only

Argument	Type	Description
search	string	Only folders whose name matches this text.
space_id	string	Only folders in this space.
folder_id	string	Only folders below this folder.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only folders whose name matches this text."
    },
    "space_id": {
      "type": "string",
      "pattern": "^[1-9]\\d{0,18}$",
      "description": "Only folders in this space."
    },
    "folder_id": {
      "type": "string",
      "pattern": "^[1-9]\\d{0,18}$",
      "description": "Only folders below this folder."
    }
  }
}

paperform_list_papersign_spaces

List Papersign spaces (id, name, root_folder_id). Needs the Papersign API. Paperform: GET /papersign/spaces.

read-only

Argument	Type	Description
search	string	Only spaces whose name matches this text.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only spaces whose name matches this text."
    }
  }
}

paperform_list_partial_submissions

List one page of a form's partial submissions (someone started the form), newest first: answers so far, last_answered field, dates. Partials that were later completed stay in the list with submitted_at set; only those with submitted_at null are abandoned. Useful for drop-off analysis and follow-ups. Paperform: GET /forms/{slug_or_id}/partial-submissions.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
before_id	string	Cursor: only results before this id.
after_date	string	Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set.
before_date

paperform_list_products

List the products sold on a form (SKU, name, price, quantity in stock, sold, minimum/maximum, discountable, images). Paperform: GET /forms/{slug_or_id}/products.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
search	string	Only products whose name matches this text.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form"
  ],
  "properties": {
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only products whose name matches this text."
    }
  }
}

paperform_list_space_forms

List the forms in one space. Needs the Business API. Paperform: GET /spaces/{id}/forms.

read-only

Argument	Type	Description
space_id*	string	The space id (from paperform_list_spaces, or a form's space_id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "space_id"
  ],
  "properties": {
    "space_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The space id (from paperform_list_spaces, or a form's space_id)."
    }
  }
}

paperform_list_spaces

List the account's spaces (folders that group forms): id, name, dates. Needs the Business API. Paperform: GET /spaces.

read-only

Argument	Type	Description
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
search	string	Only spaces whose name matches this text.
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
before_id	string	Cursor: only results before this id.
after_date	string	Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set.
before_date	string	Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set.

Input schema (JSON)

paperform_list_submissions

List one page of a form's completed submissions, newest first: answers (`data`, keyed by field key — see paperform_list_form_fields), device and UTM info, payment `charge`, generated PDFs and created_at. Page with skip/next_skip or after_id/last_id; filter by date. Paperform: GET /forms/{slug_or_id}/submissions.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
before_id	string	Cursor: only results before this id.
after_date	string	Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set.
before_date	string

paperform_list_webhooks

List the webhooks on a form (id, target_url, triggers: submission / partial_submission, dates). Needs the Business API. Paperform: GET /forms/{slug_or_id}/webhooks.

read-only

Argument	Type	Description
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
skip	integer	Results to skip (offset). Pass the previous reply's next_skip.
sort	string	Sort by created_at: DESC (default, newest first) or ASC.
limit	integer	Results per page, 1-100 (Paperform default 20).
after_id	string	Cursor: only results after this id (e.g. the previous reply's last_id).
before_id	string	Cursor: only results before this id.
after_date	string	Only results created after this ISO 8601 date-time (UTC). Ignored by Paperform when after_id is set.
before_date	string	Only results created before this ISO 8601 date-time (UTC). Ignored by Paperform when before_id is set.

paperform_set_product_quantity

WRITE: set how many units of a form product are available (its stock quantity), e.g. after restocking. Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/quantity.

destructive

Argument	Type	Description
sku*	string	The product SKU (from paperform_list_products).
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
quantity*	integer	The new stock quantity (0 or more).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "sku",
    "quantity"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The product SKU (from paperform_list_products)."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "quantity": {
      "type": "integer",
      "maximum": 100000000,
      "minimum": 0,
      "description": "The new stock quantity (0 or more)."
    }
  }
}

paperform_set_product_sold

WRITE: set the number of units of a form product recorded as sold (e.g. to correct it after a refund or an offline sale). Replaces the current value; read it first with paperform_get_product. Not atomic: it overwrites rather than adjusts, so a sale between your read and this write is lost. Paperform: PUT /forms/{slug_or_id}/products/{sku}/sold.

destructive

Argument	Type	Description
sku*	string	The product SKU (from paperform_list_products).
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
sold*	integer	The new sold count (0 or more).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "sku",
    "sold"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The product SKU (from paperform_list_products)."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "sold": {
      "type": "integer",
      "maximum": 100000000,
      "minimum": 0,
      "description": "The new sold count (0 or more)."
    }
  }
}

paperform_update_coupon

WRITE: change a coupon on a form — enable or disable it, change its discount (amount or percentage), target or expiry (null = never expires). Only the fields you pass are sent. Paperform: PUT /forms/{slug_or_id}/coupons/{code}.

destructive

Argument	Type	Description
code*	string	The coupon code, e.g. DISCOUNT1.
form*	string	The form's slug, custom slug or id (from paperform_list_forms).
target	string	What the discount applies to: the one-off price or a subscription.
enabled	boolean	Whether respondents can use the coupon.
expiresAt	any	When the coupon expires (ISO 8601 with a timezone), or null for no expiry.
discountAmount	number	A fixed discount, in the form's currency (e.g. 10 = 10.00).
discountPercentage	number	A percentage discount, 0-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "form",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The coupon code, e.g. DISCOUNT1."
    },
    "form": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The form's slug, custom slug or id (from paperform_list_forms)."
    },
    "target": {
      "enum": [
        "price",
        "subscription"
      ],
      "type": "string",
      "description": "What the discount applies to: the one-off price or a subscription."
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether respondents can use the coupon."
    },
    "expiresAt": {
      "anyOf": [
        {
          "type": "string",
          "description": "ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z (sent to Paperform in UTC)."
        },
        {
          "type": "null"
        }
      ],
      "description": "When the coupon expires (ISO 8601 with a timezone), or null for no expiry."
    },
    "discountAmount": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0,
      "description": "A fixed discount, in the form's currency (e.g. 10 = 10.00)."
    },
    "discountPercentage": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "A percentage discount, 0-100."
    }
  }
}

Paperform MCP by usefulapi

Try it

paperform_create_coupon Destructive

Paperform MCP by usefulapi

Try it

paperform_create_coupon Destructive

Tools (23)