Notion Entitlement

​

What Gets Delivered

• The customer connects their Notion workspace from the Customer Portal. The payment confirmation email marks the entitlement Action Required and links to the portal.
• After they authorize, Dodo Payments copies the configured template into a page the customer shared during authorization, in the workspace they chose.
• When the grant is revoked, the copy stays in the customer’s workspace. Dodo Payments marks the grant Revoked for record-keeping and doesn’t delete the copy.

​

Connect Notion

1

Open Entitlements

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

2

Pick Notion

Choose Notion Template as the integration. If Notion isn’t connected yet, click Connect Notion.

Notion opens in a new tab. Sign in to the workspace that owns your source templates and review the permissions Dodo Payments requests. Then pick the pages (templates) the integration can read and copy.

When Notion redirects back, a confirmation page shows that the workspace is connected.

3

Pick a Template

Back in the dashboard, select the template to copy under Template. Only pages you shared in the previous step appear here. Enter a Name for the entitlement and click Create Entitlement.

4

Attach It to a Product

Attach the entitlement to any product. See Attach Entitlements to Products.

​

Customer Flow

1. The customer completes checkout.
2. Dodo Payments creates a grant in Pending status. Dodo Payments tries to create a Notion authorization URL right away and stores it in oauth_url. If that fails, oauth_url stays null until the customer starts the accept flow.
3. In the Customer Portal, the customer clicks Connect on the entitlement, authorizes with Notion, picks the workspace to receive the template, and shares at least one page with Dodo Payments.
4. Dodo Payments copies the template into a shared page in that workspace. The grant moves to Delivered.
5. On revocation, the grant is marked Revoked, and the copy remains in the customer’s workspace.

​

Required Configuration

​

Create via API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: '3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c',
  },
});

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

entitlement = client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"},
)

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
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("3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created fires with status: "Pending". oauth_url may already hold the Notion authorization URL. If it is null, it is populated once the customer starts the accept flow from the Customer Portal.
• entitlement_grant.delivered fires once the template is copied.
• entitlement_grant.revoked fires on cancellation. The customer’s copy is left untouched.

​

Troubleshooting