BUSINESS · TASKS
Letters, postcards, and cheques mailed from the account that person connected.
Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.
Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.
Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.
Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.
postgrid_delete_print_mail_v1_bank_accounts_by_idWRITEBank accounts - delete via DELETE /print-mail/v1/bank_accounts/{id}
postgrid_delete_print_mail_v1_boxes_by_idWRITEBoxes - delete via DELETE /print-mail/v1/boxes/{id}
postgrid_delete_print_mail_v1_campaigns_by_idWRITECampaigns - delete via DELETE /print-mail/v1/campaigns/{id}
postgrid_delete_print_mail_v1_cheques_by_idWRITECheques - delete via DELETE /print-mail/v1/cheques/{id}
postgrid_delete_print_mail_v1_contacts_by_idWRITEContacts - delete via DELETE /print-mail/v1/contacts/{id}
postgrid_delete_print_mail_v1_letters_by_idWRITELetters - delete via DELETE /print-mail/v1/letters/{id}
postgrid_delete_print_mail_v1_mailing_list_imports_by_idWRITEMailing list imports - delete via DELETE /print-mail/v1/mailing_list_imports/{id}
postgrid_delete_print_mail_v1_mailing_lists_by_idWRITEMailing lists - delete via DELETE /print-mail/v1/mailing_lists/{id}
postgrid_delete_print_mail_v1_postcards_by_idWRITEPostcards - delete via DELETE /print-mail/v1/postcards/{id}
postgrid_delete_print_mail_v1_reports_by_idWRITEReports - delete report via DELETE /print-mail/v1/reports/{id}
postgrid_delete_print_mail_v1_reports_by_reportid_exports_by_exportidWRITEReports - delete report export via DELETE /print-mail/v1/reports/{reportID}/exports/{exportID}
postgrid_delete_print_mail_v1_return_envelopes_by_id_orders_by_orderidWRITEReturn envelopes - cancel order via DELETE /print-mail/v1/return_envelopes/{id}/orders/{orderID}
postgrid_delete_print_mail_v1_self_mailers_by_idWRITESelf mailers - delete via DELETE /print-mail/v1/self_mailers/{id}
postgrid_delete_print_mail_v1_snap_packs_by_idWRITESnap packs - cancel via DELETE /print-mail/v1/snap_packs/{id}
postgrid_delete_print_mail_v1_targeted_list_builds_by_idWRITETargeted list builds - delete via DELETE /print-mail/v1/targeted_list_builds/{id}
postgrid_delete_print_mail_v1_template_editor_sessions_by_idWRITETemplate editor sessions - delete via DELETE /print-mail/v1/template_editor_sessions/{id}
postgrid_delete_print_mail_v1_templates_by_idWRITETemplates - delete via DELETE /print-mail/v1/templates/{id}
postgrid_delete_print_mail_v1_trackers_by_idWRITETrackers - delete via DELETE /print-mail/v1/trackers/{id}
postgrid_delete_print_mail_v1_webhooks_by_idWRITEWebhooks - delete via DELETE /print-mail/v1/webhooks/{id}
postgrid_get_print_mail_v1_bank_accountsREADBank accounts - list via GET /print-mail/v1/bank_accounts. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_bank_accounts_by_idREADBank accounts - get via GET /print-mail/v1/bank_accounts/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_boxesREADBoxes - list via GET /print-mail/v1/boxes. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_boxes_by_idREADBoxes - get via GET /print-mail/v1/boxes/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_campaignsREADCampaigns - list via GET /print-mail/v1/campaigns. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_campaigns_by_idREADCampaigns - get via GET /print-mail/v1/campaigns/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_chequesREADCheques - list via GET /print-mail/v1/cheques. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_cheques_by_idREADCheques - get via GET /print-mail/v1/cheques/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_cheques_by_id_urlREADCheques - get URL via GET /print-mail/v1/cheques/{id}/url. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_cheques_by_id_with_deposit_ready_pdfREADCheques - get deposit ready PDF via GET /print-mail/v1/cheques/{id}/with_deposit_ready_pdf. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_contactsREADContacts - list via GET /print-mail/v1/contacts. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_contacts_by_idREADContacts - get via GET /print-mail/v1/contacts/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_eventsREADEvents - list via GET /print-mail/v1/events. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_lettersREADLetters - list via GET /print-mail/v1/letters. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_letters_by_idREADLetters - get via GET /print-mail/v1/letters/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_letters_by_id_urlREADLetters - get URL via GET /print-mail/v1/letters/{id}/url. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_mailing_list_importsREADMailing list imports - list via GET /print-mail/v1/mailing_list_imports. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_mailing_list_imports_by_idREADMailing list imports - get via GET /print-mail/v1/mailing_list_imports/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_mailing_listsREADMailing lists - list via GET /print-mail/v1/mailing_lists. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_mailing_lists_by_idREADMailing lists - get via GET /print-mail/v1/mailing_lists/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_postcardsREADPostcards - list via GET /print-mail/v1/postcards. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_postcards_by_idREADPostcards - get via GET /print-mail/v1/postcards/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_postcards_by_id_urlREADPostcards - get URL via GET /print-mail/v1/postcards/{id}/url. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_reportsREADReports - list reports via GET /print-mail/v1/reports. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_reports_by_idREADReports - get report via GET /print-mail/v1/reports/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_reports_by_reportid_exports_by_exportidREADReports - get report export via GET /print-mail/v1/reports/{reportID}/exports/{exportID}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_return_envelopesREADReturn envelopes - list via GET /print-mail/v1/return_envelopes. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_return_envelopes_by_idREADReturn envelopes - get via GET /print-mail/v1/return_envelopes/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_return_envelopes_by_id_ordersREADReturn envelopes - list orders via GET /print-mail/v1/return_envelopes/{id}/orders. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_return_envelopes_by_id_orders_by_orderidREADReturn envelopes - get order via GET /print-mail/v1/return_envelopes/{id}/orders/{orderID}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_self_mailersREADSelf mailers - list via GET /print-mail/v1/self_mailers. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_self_mailers_by_idREADSelf mailers - get via GET /print-mail/v1/self_mailers/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_self_mailers_by_id_urlREADSelf mailers - get URL via GET /print-mail/v1/self_mailers/{id}/url. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_snap_packsREADSnap packs - list via GET /print-mail/v1/snap_packs. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_snap_packs_by_idREADSnap packs - get via GET /print-mail/v1/snap_packs/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_snap_packs_capabilitiesREADSnap packs - capabilities via GET /print-mail/v1/snap_packs/capabilities. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_sub_organizationsREADSub organizations - list via GET /print-mail/v1/sub_organizations. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_sub_organizations_by_idREADSub organizations - get via GET /print-mail/v1/sub_organizations/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_sub_organizations_by_id_usersREADSub organizations - list users via GET /print-mail/v1/sub_organizations/{id}/users. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_targeted_list_buildsREADTargeted list builds - list via GET /print-mail/v1/targeted_list_builds. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_targeted_list_builds_by_idREADTargeted list builds - get via GET /print-mail/v1/targeted_list_builds/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_template_editor_sessionsREADTemplate editor sessions - list via GET /print-mail/v1/template_editor_sessions. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_templatesREADTemplates - list via GET /print-mail/v1/templates. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_templates_by_idREADTemplates - get via GET /print-mail/v1/templates/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_trackersREADTrackers - list via GET /print-mail/v1/trackers. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_trackers_by_idREADTrackers - get via GET /print-mail/v1/trackers/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_trackers_by_id_visitsREADTrackers - list visits via GET /print-mail/v1/trackers/{id}/visits. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_virtual_mailboxesREADVirtual mailboxes - list via GET /print-mail/v1/virtual_mailboxes. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_virtual_mailboxes_by_idREADVirtual mailboxes - retrieve via GET /print-mail/v1/virtual_mailboxes/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_virtual_mailboxes_by_id_addressREADVirtual mailboxes - retrieve address via GET /print-mail/v1/virtual_mailboxes/{id}/address. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_virtual_mailboxes_by_id_itemsREADVirtual mailboxes - list items via GET /print-mail/v1/virtual_mailboxes/{id}/items. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_virtual_mailboxes_by_id_items_by_itemidREADVirtual mailboxes - retrieve item via GET /print-mail/v1/virtual_mailboxes/{id}/items/{itemID}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_webhooksREADWebhooks - list via GET /print-mail/v1/webhooks. PostGrid rate-limits list reads to 10 per minute.
postgrid_get_print_mail_v1_webhooks_by_idREADWebhooks - get via GET /print-mail/v1/webhooks/{id}. PostGrid rate-limits individual reads to 50 per minute.
postgrid_get_print_mail_v1_webhooks_by_id_invocationsREADWebhooks - list invocations via GET /print-mail/v1/webhooks/{id}/invocations. PostGrid rate-limits list reads to 10 per minute.
postgrid_post_print_mail_v1_bank_accountsWRITEBank accounts - create via POST /print-mail/v1/bank_accounts
postgrid_post_print_mail_v1_boxesWRITEBoxes - create via POST /print-mail/v1/boxes. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_boxes_by_id_progressionsWRITEBoxes - progress via POST /print-mail/v1/boxes/{id}/progressions
postgrid_post_print_mail_v1_campaignsWRITECampaigns - create via POST /print-mail/v1/campaigns
postgrid_post_print_mail_v1_campaigns_by_idWRITECampaigns - update via POST /print-mail/v1/campaigns/{id}
postgrid_post_print_mail_v1_campaigns_by_id_sendWRITECampaigns - send via POST /print-mail/v1/campaigns/{id}/send. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_chequesWRITECheques - create via POST /print-mail/v1/cheques. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_cheques_by_id_cancellationWRITECheques - cancel with note via POST /print-mail/v1/cheques/{id}/cancellation
postgrid_post_print_mail_v1_cheques_by_id_progressionsWRITECheques - progress via POST /print-mail/v1/cheques/{id}/progressions
postgrid_post_print_mail_v1_contactsWRITEContacts - create via POST /print-mail/v1/contacts
postgrid_post_print_mail_v1_lettersWRITELetters - create via POST /print-mail/v1/letters. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_letters_by_id_cancellationWRITELetters - cancel with note via POST /print-mail/v1/letters/{id}/cancellation
postgrid_post_print_mail_v1_letters_by_id_progressionsWRITELetters - progress via POST /print-mail/v1/letters/{id}/progressions
postgrid_post_print_mail_v1_mailing_list_importsWRITEMailing list imports - create via POST /print-mail/v1/mailing_list_imports
postgrid_post_print_mail_v1_mailing_list_imports_by_idWRITEMailing list imports - update via POST /print-mail/v1/mailing_list_imports/{id}
postgrid_post_print_mail_v1_mailing_listsWRITEMailing lists - create via POST /print-mail/v1/mailing_lists
postgrid_post_print_mail_v1_mailing_lists_by_idWRITEMailing lists - update via POST /print-mail/v1/mailing_lists/{id}
postgrid_post_print_mail_v1_mailing_lists_by_id_jobsWRITEMailing lists - mailing list jobs via POST /print-mail/v1/mailing_lists/{id}/jobs
postgrid_post_print_mail_v1_postcardsWRITEPostcards - create via POST /print-mail/v1/postcards. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_postcards_by_id_cancellationWRITEPostcards - cancel with note via POST /print-mail/v1/postcards/{id}/cancellation
postgrid_post_print_mail_v1_postcards_by_id_progressionsWRITEPostcards - progress via POST /print-mail/v1/postcards/{id}/progressions
postgrid_post_print_mail_v1_reportsWRITEReports - create report via POST /print-mail/v1/reports
postgrid_post_print_mail_v1_reports_by_idWRITEReports - update report via POST /print-mail/v1/reports/{id}
postgrid_post_print_mail_v1_reports_by_id_samplesWRITEReports - run saved report sample via POST /print-mail/v1/reports/{id}/samples
postgrid_post_print_mail_v1_reports_by_reportid_exportsWRITEReports - create report export via POST /print-mail/v1/reports/{reportID}/exports
postgrid_post_print_mail_v1_reports_samplesWRITEReports - run ad hoc sample via POST /print-mail/v1/reports/samples
postgrid_post_print_mail_v1_return_envelopesWRITEReturn envelopes - create via POST /print-mail/v1/return_envelopes
postgrid_post_print_mail_v1_return_envelopes_by_id_ordersWRITEReturn envelopes - create order via POST /print-mail/v1/return_envelopes/{id}/orders. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_return_envelopes_by_id_orders_by_orderid_fillsWRITEReturn envelopes - fill test order via POST /print-mail/v1/return_envelopes/{id}/orders/{orderID}/fills
postgrid_post_print_mail_v1_self_mailersWRITESelf mailers - create via POST /print-mail/v1/self_mailers. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_self_mailers_by_id_progressionsWRITESelf mailers - progress via POST /print-mail/v1/self_mailers/{id}/progressions
postgrid_post_print_mail_v1_snap_packsWRITESnap packs - create via POST /print-mail/v1/snap_packs. In live mode this produces real physical mail and is billed to the connected PostGrid organization; with a test key the order completes and previews render but nothing is printed or mailed and the address is NOT verified.
postgrid_post_print_mail_v1_snap_packs_by_id_progressionsWRITESnap packs - progress via POST /print-mail/v1/snap_packs/{id}/progressions
postgrid_post_print_mail_v1_sub_organizationsWRITESub organizations - create via POST /print-mail/v1/sub_organizations
postgrid_post_print_mail_v1_targeted_list_buildsWRITETargeted list builds - create via POST /print-mail/v1/targeted_list_builds
postgrid_post_print_mail_v1_targeted_list_builds_by_idWRITETargeted list builds - update via POST /print-mail/v1/targeted_list_builds/{id}
postgrid_post_print_mail_v1_targeted_list_builds_by_id_confirmWRITETargeted list builds - confirm via POST /print-mail/v1/targeted_list_builds/{id}/confirm
postgrid_post_print_mail_v1_targeted_list_builds_filters_autocompleteWRITETargeted list builds - autocomplete via POST /print-mail/v1/targeted_list_builds/filters/autocomplete
postgrid_post_print_mail_v1_template_editor_sessionsWRITETemplate editor sessions - create via POST /print-mail/v1/template_editor_sessions
postgrid_post_print_mail_v1_templatesWRITETemplates - create via POST /print-mail/v1/templates
postgrid_post_print_mail_v1_templates_by_idWRITETemplates - update via POST /print-mail/v1/templates/{id}
postgrid_post_print_mail_v1_trackersWRITETrackers - create via POST /print-mail/v1/trackers
postgrid_post_print_mail_v1_trackers_by_idWRITETrackers - update via POST /print-mail/v1/trackers/{id}
postgrid_post_print_mail_v1_virtual_mailboxesWRITEVirtual mailboxes - create via POST /print-mail/v1/virtual_mailboxes
postgrid_post_print_mail_v1_virtual_mailboxes_by_id_itemsWRITEVirtual mailboxes - create test item via POST /print-mail/v1/virtual_mailboxes/{id}/items
postgrid_post_print_mail_v1_webhooksWRITEWebhooks - create via POST /print-mail/v1/webhooks
postgrid_post_print_mail_v1_webhooks_by_idWRITEWebhooks - update via POST /print-mail/v1/webhooks/{id}
Put PostGrid behind one governed endpoint.
Same permissions, same audit trail, whatever else you connect next.