curl -X GET "https://app.ummahspot.com/creators/monetization-settings"

{
  "monetization": {
    "platformFeePercent": 5,
    "stripeProcessingFeePercent": 2.9,
    "stripeProcessingFeeFixedCents": 30,
    "stripeFeeNote": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments.",
    "currency": "usd",
    "creatorSharePercent": 95,
    "note": "Platform fees apply before Stripe processing fees, taxes, refunds, and disputes.",
    "stripeFeeDisclaimer": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments.",
    "defaultPlatformFeePercent": 5,
    "customPlatformFeePercent": null,
    "usesCustomPlatformFee": false
  }
}

curl -X POST "https://app.ummahspot.com/creators/apply" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"bio":"string"}'

{
  "application": {
    "_id": "66f1a2b3c4d5e6f7a8b9c0d1",
    "user": "64a1b2c3d4e5f6a7b8c9d0e1",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "audience": "Intermediate students of knowledge",
    "sampleContent": "https://sharhapp.com/books/64b2c3d4e5f6a7b8c9d0e1f2",
    "status": "pending",
    "reviewNotes": "",
    "reviewedAt": null,
    "reviewedBy": null,
    "createdAt": "2026-09-18T10:15:00.000Z",
    "updatedAt": "2026-09-18T10:15:00.000Z",
    "__v": 0
  }
}

curl -X GET "https://app.ummahspot.com/creators/me/dashboard" \
  -H "Authorization: Bearer $SHARH_TOKEN"

{
  "creator": {
    "id": "64a1b2c3d4e5f6a7b8c9d0e1",
    "username": "ustadh_yusuf",
    "profilePicture": "https://example-bucket.s3.amazonaws.com/profile-pictures/64a1b2c3.jpg",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "publicationTitle": "The Fiqh Notebook",
    "slug": "fiqh-notebook",
    "coverImage": "https://example.com/cover.jpg",
    "bannerText": "New commentary every week",
    "featuredQuote": "Knowledge is a trust.",
    "socialLinks": {
      "website": "https://example.com",
      "x": "",
      "youtube": "https://youtube.com/@fiqhnotebook",
      "instagram": ""
    },
    "creatorStatus": "approved"
  },
  "creatorProfile": {
    "status": "approved",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "publicationTitle": "The Fiqh Notebook",
    "slug": "fiqh-notebook",
    "coverImage": "https://example.com/cover.jpg",
    "bannerText": "New commentary every week",
    "featuredQuote": "Knowledge is a trust.",
    "socialLinks": {
      "website": "https://example.com",
      "x": "",
      "youtube": "https://youtube.com/@fiqhnotebook",
      "instagram": ""
    },
    "approvedAt": "2026-08-01T09:00:00.000Z",
    "approvedBy": "64a0000000000000000000aa",
    "customPlatformFeePercent": null,
    "stripeConnectAccountId": "acct_XXXXXXXXXXXXXXXX",
    "stripeConnectOnboarded": true,
    "stripeChargesEnabled": true,
    "stripePayoutsEnabled": true
  },
  "application": {
    "_id": "66f1a2b3c4d5e6f7a8b9c0d1",
    "user": "64a1b2c3d4e5f6a7b8c9d0e1",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "audience": "Intermediate students of knowledge",
    "sampleContent": "",
    "status": "approved",
    "reviewNotes": "",
    "reviewedAt": "2026-08-01T09:00:00.000Z",
    "reviewedBy": "64a0000000000000000000aa",
    "createdAt": "2026-07-28T10:15:00.000Z",
    "updatedAt": "2026-08-01T09:00:00.000Z",
    "__v": 0
  },
  "monetization": {
    "platformFeePercent": 5,
    "stripeProcessingFeePercent": 2.9,
    "stripeProcessingFeeFixedCents": 30,
    "stripeFeeNote": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments.",
    "currency": "usd",
    "creatorSharePercent": 95,
    "note": "Platform fees apply before Stripe processing fees, taxes, refunds, and disputes.",
    "stripeFeeDisclaimer": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments.",
    "defaultPlatformFeePercent": 5,
    "customPlatformFeePercent": null,
    "usesCustomPlatformFee": false
  },
  "stats": {
    "totalSubscribers": 1,
    "monthlyRecurringRevenueCents": 500,
    "grossMonthlyRecurringRevenueCents": 500,
    "monthlyPlatformFeeCents": 25,
    "monthlyCreatorShareCents": 475,
    "monthlyEstimatedStripeFeeCents": 44,
    "monthlyEstimatedCreatorNetCents": 431,
    "bookCount": 1,
    "noteCount": 1,
    "updateCount": 1,
    "exclusivePostCount": 2
  },
  "plans": [
    {
      "id": "66f2b3c4d5e6f7a8b9c0d1e2",
      "tierNumber": 1,
      "name": "Supporter",
      "description": "Access to subscriber-only updates and tier 1 releases.",
      "monthlyPriceCents": 500,
      "currency": "usd",
      "subscriberCount": 1,
      "isActive": true,
      "monetization": {
        "currency": "usd",
        "grossAmountCents": 500,
        "platformFeePercent": 5,
        "creatorSharePercent": 95,
        "platformFeeCents": 25,
        "creatorShareCents": 475,
        "stripeProcessingFeePercent": 2.9,
        "stripeProcessingFeeFixedCents": 30,
        "estimatedStripeFeeCents": 44,
        "estimatedCreatorNetCents": 431,
        "stripeFeeNote": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments."
      }
    }
  ],
  "subscribers": [
    {
      "id": "66f3c4d5e6f7a8b9c0d1e2f3",
      "status": "active",
      "tierNumber": 1,
      "cancelAtPeriodEnd": false,
      "currentPeriodEnd": "2026-10-18T10:15:00.000Z",
      "joinedAt": "2026-09-18T10:15:00.000Z",
      "subscriber": {
        "id": "64c3d4e5f6a7b8c9d0e1f2a3",
        "username": "student_ahmad",
        "profilePicture": null
      },
      "plan": {
        "id": "66f2b3c4d5e6f7a8b9c0d1e2",
        "name": "Supporter",
        "monthlyPriceCents": 500,
        "currency": "usd"
      }
    }
  ],
  "books": [
    {
      "id": "64b2c3d4e5f6a7b8c9d0e1f2",
      "title": "Matn Abi Shuja - Annotated",
      "description": "Line-by-line commentary.",
      "visibility": "public",
      "accessModel": "creator_subscription",
      "requiredSubscriptionTier": 1,
      "lastUpdated": "2026-09-10T08:00:00.000Z"
    }
  ],
  "notes": [
    {
      "id": "65d4e5f6a7b8c9d0e1f2a3b4",
      "title": "Chapter of Purification - Study Notes",
      "visibility": "public",
      "accessModel": "public",
      "requiredSubscriptionTier": null,
      "summary": "An overview of the categories of water and their rulings.",
      "lastModified": "2026-09-12T14:30:00.000Z"
    }
  ],
  "updates": [
    {
      "_id": "66f4d5e6f7a8b9c0d1e2f3a4",
      "creator": "64a1b2c3d4e5f6a7b8c9d0e1",
      "title": "September release schedule",
      "content": "This month we begin the chapter of prayer. New lines every Friday.",
      "previewText": "This month we begin the chapter of prayer. New lines every Friday.",
      "visibility": "subscribers",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedAt": "2026-09-01T12:00:00.000Z",
      "__v": 0
    }
  ]
}

curl -X PATCH "https://app.ummahspot.com/creators/me/profile" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tagline":"string"}'

{
  "creatorProfile": {
    "status": "approved",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "publicationTitle": "The Fiqh Notebook",
    "slug": "fiqh-notebook",
    "coverImage": "https://example.com/cover.jpg",
    "bannerText": "New commentary every week",
    "featuredQuote": "Knowledge is a trust.",
    "socialLinks": {
      "website": "https://example.com",
      "x": "",
      "youtube": "https://youtube.com/@fiqhnotebook",
      "instagram": ""
    },
    "approvedAt": "2026-08-01T09:00:00.000Z",
    "approvedBy": "64a0000000000000000000aa",
    "customPlatformFeePercent": null,
    "stripeConnectAccountId": "acct_XXXXXXXXXXXXXXXX",
    "stripeConnectOnboarded": true,
    "stripeChargesEnabled": true,
    "stripePayoutsEnabled": true
  }
}

curl -X POST "https://app.ummahspot.com/creators/me/connect/account-session" \
  -H "Authorization: Bearer $SHARH_TOKEN"

{
  "accountId": "acct_XXXXXXXXXXXXXXXX",
  "clientSecret": "accs_secret__XXXXXXXXXXXXXXXXXXXXXXXX"
}

curl -X PUT "https://app.ummahspot.com/creators/me/plans/:tierNumber" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","description":"string","monthlyPriceCents":0}'

{
  "plan": {
    "_id": "66f2b3c4d5e6f7a8b9c0d1e2",
    "creator": "64a1b2c3d4e5f6a7b8c9d0e1",
    "tierNumber": 1,
    "name": "Supporter",
    "description": "Access to subscriber-only updates and tier 1 releases.",
    "monthlyPriceCents": 500,
    "currency": "usd",
    "stripeProductId": "prod_XXXXXXXXXXXXXX",
    "stripePriceId": "price_XXXXXXXXXXXXXXXXXXXXXXXX",
    "isActive": true,
    "createdAt": "2026-09-18T10:15:00.000Z",
    "updatedAt": "2026-09-18T10:15:00.000Z",
    "__v": 0
  }
}

curl -X PATCH "https://app.ummahspot.com/creators/me/books/:bookId/access" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"accessModel":"string"}'

{
  "book": {
    "id": "64b2c3d4e5f6a7b8c9d0e1f2",
    "title": "Matn Abi Shuja - Annotated",
    "description": "Line-by-line commentary.",
    "visibility": "public",
    "accessModel": "creator_subscription",
    "requiredSubscriptionTier": 2,
    "lastUpdated": "2026-09-10T08:00:00.000Z"
  }
}

curl -X PATCH "https://app.ummahspot.com/creators/me/notes/:noteId/access" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"accessModel":"string"}'

{
  "note": {
    "id": "65d4e5f6a7b8c9d0e1f2a3b4",
    "title": "Chapter of Purification - Study Notes",
    "visibility": "public",
    "accessModel": "creator_subscription",
    "requiredSubscriptionTier": 1,
    "summary": "An overview of the categories of water and their rulings.",
    "lastModified": "2026-09-12T14:30:00.000Z"
  }
}

curl -X POST "https://app.ummahspot.com/creators/me/updates" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"string"}'

{
  "update": {
    "_id": "66f4d5e6f7a8b9c0d1e2f3a4",
    "creator": "64a1b2c3d4e5f6a7b8c9d0e1",
    "title": "September release schedule",
    "content": "This month we begin the chapter of prayer. New lines every Friday.",
    "previewText": "This month we begin the chapter of prayer. New lines every Friday.",
    "visibility": "subscribers",
    "createdAt": "2026-09-18T10:15:00.000Z",
    "updatedAt": "2026-09-18T10:15:00.000Z",
    "__v": 0
  }
}

curl -X DELETE "https://app.ummahspot.com/creators/me/updates/:updateId" \
  -H "Authorization: Bearer $SHARH_TOKEN"

{
  "success": true
}

curl -X POST "https://app.ummahspot.com/creators/:creatorId/checkout" \
  -H "Authorization: Bearer $SHARH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tierNumber":0}'

{
  "id": "cs_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "url": "https://checkout.stripe.com/c/pay/cs_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

curl -X GET "https://app.ummahspot.com/creators/notes/:noteId" \
  -H "Authorization: Bearer $SHARH_TOKEN"

{
  "note": {
    "id": "65d4e5f6a7b8c9d0e1f2a3b4",
    "title": "Chapter of Purification - Study Notes",
    "summary": "An overview of the categories of water and their rulings.",
    "sections": [
      {
        "id": "65d4e5f6a7b8c9d0e1f2a3b5",
        "title": "Categories of water",
        "notes": "[{\"id\":\"b1\",\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Water is of four categories...\",\"styles\":{}}]}]"
      }
    ],
    "visibility": "public",
    "accessModel": "creator_subscription",
    "requiredSubscriptionTier": 1,
    "lastModified": "2026-09-12T14:30:00.000Z",
    "creator": {
      "id": "64a1b2c3d4e5f6a7b8c9d0e1",
      "username": "ustadh_yusuf",
      "profilePicture": null,
      "tagline": "Classical fiqh texts made approachable",
      "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
      "publicationTitle": "The Fiqh Notebook",
      "slug": "fiqh-notebook",
      "coverImage": "https://example.com/cover.jpg",
      "bannerText": "New commentary every week",
      "featuredQuote": "Knowledge is a trust.",
      "socialLinks": {
        "website": "https://example.com",
        "x": "",
        "youtube": "https://youtube.com/@fiqhnotebook",
        "instagram": ""
      },
      "creatorStatus": "approved"
    }
  }
}

curl -X GET "https://app.ummahspot.com/creators"

{
  "creators": [
    {
      "id": "64a1b2c3d4e5f6a7b8c9d0e1",
      "username": "ustadh_yusuf",
      "profilePicture": "https://example-bucket.s3.amazonaws.com/profile-pictures/64a1b2c3.jpg",
      "tagline": "Classical fiqh texts made approachable",
      "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
      "publicationTitle": "The Fiqh Notebook",
      "slug": "fiqh-notebook",
      "coverImage": "https://example.com/cover.jpg",
      "bannerText": "New commentary every week",
      "featuredQuote": "Knowledge is a trust.",
      "socialLinks": {
        "website": "https://example.com",
        "x": "",
        "youtube": "https://youtube.com/@fiqhnotebook",
        "instagram": ""
      },
      "creatorStatus": "approved",
      "bookCount": 3,
      "noteCount": 5,
      "plans": [
        {
          "id": "66f2b3c4d5e6f7a8b9c0d1e2",
          "tierNumber": 1,
          "name": "Supporter",
          "description": "Access to subscriber-only updates and tier 1 releases.",
          "monthlyPriceCents": 500,
          "currency": "usd",
          "subscriberCount": 0,
          "isActive": true,
          "monetization": {
            "currency": "usd",
            "grossAmountCents": 500,
            "platformFeePercent": 5,
            "creatorSharePercent": 95,
            "platformFeeCents": 25,
            "creatorShareCents": 475,
            "stripeProcessingFeePercent": 2.9,
            "stripeProcessingFeeFixedCents": 30,
            "estimatedStripeFeeCents": 44,
            "estimatedCreatorNetCents": 431,
            "stripeFeeNote": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments."
          }
        }
      ],
      "stats": {
        "totalSubscribers": 12,
        "tierCount": 1,
        "startingPriceCents": 500,
        "highestPriceCents": 500,
        "publicReleaseCount": 8,
        "subscriberOnlyReleaseCount": 2
      }
    }
  ]
}

curl -X GET "https://app.ummahspot.com/creators/:creatorId" \
  -H "Authorization: Bearer $SHARH_TOKEN"

{
  "creator": {
    "id": "64a1b2c3d4e5f6a7b8c9d0e1",
    "username": "ustadh_yusuf",
    "profilePicture": "https://example-bucket.s3.amazonaws.com/profile-pictures/64a1b2c3.jpg",
    "tagline": "Classical fiqh texts made approachable",
    "bio": "I have taught Shafi'i fiqh for ten years and publish annotated translations.",
    "publicationTitle": "The Fiqh Notebook",
    "slug": "fiqh-notebook",
    "coverImage": "https://example.com/cover.jpg",
    "bannerText": "New commentary every week",
    "featuredQuote": "Knowledge is a trust.",
    "socialLinks": {
      "website": "https://example.com",
      "x": "",
      "youtube": "https://youtube.com/@fiqhnotebook",
      "instagram": ""
    },
    "creatorStatus": "approved"
  },
  "plans": [
    {
      "id": "66f2b3c4d5e6f7a8b9c0d1e2",
      "tierNumber": 1,
      "name": "Supporter",
      "description": "Access to subscriber-only updates and tier 1 releases.",
      "monthlyPriceCents": 500,
      "currency": "usd",
      "subscriberCount": 12,
      "isActive": true,
      "monetization": {
        "currency": "usd",
        "grossAmountCents": 500,
        "platformFeePercent": 5,
        "creatorSharePercent": 95,
        "platformFeeCents": 25,
        "creatorShareCents": 475,
        "stripeProcessingFeePercent": 2.9,
        "stripeProcessingFeeFixedCents": 30,
        "estimatedStripeFeeCents": 44,
        "estimatedCreatorNetCents": 431,
        "stripeFeeNote": "Stripe fees are estimates for standard domestic card payments and can vary based on card type, country, disputes, taxes, and other Stripe adjustments."
      }
    }
  ],
  "currentSubscription": {
    "id": "66f3c4d5e6f7a8b9c0d1e2f3",
    "tierNumber": 1,
    "status": "active",
    "currentPeriodEnd": "2026-10-18T10:15:00.000Z",
    "cancelAtPeriodEnd": false
  },
  "viewerTier": 1,
  "canManage": false,
  "manageBooks": [],
  "manageNotes": [],
  "stats": {
    "totalSubscribers": 12,
    "exclusivePostCount": 2,
    "totalFeedItems": 3,
    "bookCount": 1,
    "noteCount": 1,
    "updateCount": 1
  },
  "feed": [
    {
      "id": "65d4e5f6a7b8c9d0e1f2a3b4",
      "type": "note",
      "title": "Chapter of Purification - Study Notes",
      "description": "An overview of the categories of water and their rulings.",
      "accessModel": "public",
      "requiredSubscriptionTier": null,
      "locked": false,
      "href": "/creator-notes/65d4e5f6a7b8c9d0e1f2a3b4",
      "publishedAt": "2026-09-12T14:30:00.000Z"
    },
    {
      "id": "64b2c3d4e5f6a7b8c9d0e1f2",
      "type": "book",
      "title": "Matn Abi Shuja - Annotated",
      "description": "Line-by-line commentary.",
      "accessModel": "creator_subscription",
      "requiredSubscriptionTier": 2,
      "locked": true,
      "href": "/books/64b2c3d4e5f6a7b8c9d0e1f2",
      "publishedAt": "2026-09-10T08:00:00.000Z"
    },
    {
      "id": "66f4d5e6f7a8b9c0d1e2f3a4",
      "type": "update",
      "title": "September release schedule",
      "content": "This month we begin the chapter of prayer. New lines every Friday.",
      "previewText": "This month we begin the chapter of prayer. New lines every Friday.",
      "description": "This month we begin the chapter of prayer. New lines every Friday.",
      "locked": false,
      "visibility": "subscribers",
      "publishedAt": "2026-09-01T12:00:00.000Z"
    }
  ]
}