Sotion Membership Management Webhooks

Automatically receive updates on members being added and removed from your Sotion website. Integrate seamlessly to any other tool in your business.

Sotion Membership Management Webhooks
Slug
member-event-webhooks
Excerpt
Automatically receive updates on members being added and removed from your Sotion website. Integrate seamlessly to any other tool in your business.

How to enable Sotion’s outbound webhooks

To get access to Sotion’s outbound webhook configuration, update your page Membership Option to one of these three options:
  • Email Sign Up
  • Restricted Email List
  • Paid Membership (Stripe, Lemon Squeezy, or Gumroad)
Then access the API menu option, scroll down to the Manage Webhooks section
notion image
notion image
 

Sotion Membership Management Webhooks Documentation

Create a new webhook

  1. From the Manage Webhooks screen, click Add New Webhook
    1. notion image
  1. Enter a name, secret, and URL for your webhook. Also select the events you want to receive
      • Name: The display name to identify your webhook in Sotion
      • Secret: A secret value to validate the event is coming from Sotion. You can enter your own value, or generate a random value. This value will be added as a x-webhook-secret header to every request.
      • URL: The URL of your webhook. Must be able to receive POST request with JSON payload
      • Events: Select the Sotion events that will be sent to your wehbook
 

When will Sotion trigger the webhook?

Depending on the Events selected Sotion will trigger under the following conditions:
member.created
  • When a new member is added via the Sotion Dashboard → Settings → Members
  • When a new member signs up via your Sotion site (applicable to sites configured with Email Signup, Restricted Email List, and Paid Membership options)
  • When a new member is added via the Sotion Members API: CREATE MEMBER
member.deleted
  • When a member is deleted via the Sotion Dashboard → Settings → Members
  • When a member is deleted via the Sotion Members API: DELETE MEMBER
 

What information will be sent to the webhook?

The webhook will receive the following payload
// request method
method: 'POST'

// headers
headers: {
  'X-Webhook-Secret': {webhook.secret},
  'Content-Type': 'application/json',
}

// body payload
body: JSON.stringify({
  eventType: {'member.created' | 'member.deleted'},
  siteId: 'E2LSI6JG7CRB8',
  status: 'active',
  domain: 'your.custom.domain',
  pageUrl: `https://your.notion.site/page-name`,
  authType: {'email', 'whitelist', 'stripe', 'lemonsq', 'gumroad'},
  member: {
	  email: 'member@email.com',
    uuid: 'af566bb1-fdb2-46c5-ae28-edgc49abfo73',
    externalId: 'some-external-id-you-can-choose',
    registeredAt: '2024-04-29T14:08:21.094Z',
    verified: {true | false},
    blocked: {true | false},
    paid: {true | false},
    loginToken: '2024-05-02T11:19:58.018Z'
  }
}
 
 

Take control of your Notion site today!

7-day free trial. No credit card needed

Connect my Notion page →
Bruce McLachlan

Written by

Bruce McLachlan

Meet Bruce, the founder behind Sotion, and explore his vision on enhancing Notion Pages. Get a glimpse of the journey and the future roadmap of Sotion.