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 with a Notion oauth_url for the customer to connect their workspace.
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 includes the Notion oauth_url.
• entitlement_grant.delivered fires once the template is duplicated.
• entitlement_grant.revoked fires on cancellation; the customer’s copy is left untouched.

​

Troubleshooting