Notion Entitlement

​

What gets delivered

• The customer is prompted to connect their Notion workspace via OAuth.
• Once authorized, Dodo Payments duplicates the configured template into the workspace they chose.
• On cancellation, the duplicated template remains in the customer’s workspace (Notion does not support remote deletion). The grant is marked Revoked for record-keeping.

​

Connect Notion

1

Open Entitlements

In your Dodo Payments dashboard, go to Entitlements and click +.

2

Pick Notion

Choose Notion Template as the integration. If Notion is not yet connected, you’ll be prompted to Connect Notion.

Clicking through opens Notion in a new tab. Sign in to the workspace that owns your source templates, review the permissions Dodo Payments requests, then pick the pages (templates) the integration is allowed to read and duplicate.

When Notion redirects back, you’ll see a confirmation that the workspace is connected.

3

Pick a template

Back in the dashboard, select the template to duplicate from the template picker. Only pages you authorized in the previous step appear here. Give the entitlement a name and click Create Entitlement.

4

Save the entitlement

Save and attach to any product.

​

Customer flow

1. The customer completes checkout.
2. Dodo Payments creates a grant in Pending status. Its oauth_url is null until the customer begins the accept flow, at which point it is populated with a Notion authorization URL.
3. The customer authorizes via the link in their email or customer portal and picks the workspace they want the template duplicated into.
4. Dodo Payments duplicates the template. The grant moves to Delivered.
5. On revocation, the grant is marked Revoked; the duplicated copy remains in the customer’s workspace.

​

Required configuration

​

Create via API

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: 'tmpl_abc123',
  },
});

client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "tmpl_abc123"},
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Study Notes"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigNotionConfigParam{
      NotionTemplateID: dodopayments.F("tmpl_abc123"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created fires with status: "Pending" and oauth_url still null; the Notion authorization URL is populated once the customer starts the accept flow from their delivery email or customer portal.
• entitlement_grant.delivered fires once the template is duplicated.
• entitlement_grant.revoked fires on cancellation; the customer’s copy is left untouched.

​

Troubleshooting