Nudgescribe API Reference
APIs
API types
  • Authentication
  • Content
  • Campaign
APIs
API types
  • Authentication
  • Content
  • Campaign
  1. Customer Groups
  • Nudgescribe API
  • Authentication
    • Authentication
    • Authenticate
      POST
    • Re-Authenticate
      GET
  • Content
    • Customers
      • Customer Management
      • Upload and Validate Customer Data
      • Get pages
      • Get Customers
      • Update Customers
      • Delete Customers
    • Customer Groups
      • Customer Groups
      • Create Customer Group
        PUT
      • Get Customer Groups
        POST
      • Update Customer Group
        PATCH
      • Delete Customer Group
        DELETE
    • Customer Profile Fields
      • Customer Profile Fields
      • Create a Custom Profile Field
      • Get Customer Profile Fields for a Workspace
      • Update Custom Fields
      • Delete Custom Fields
  • Campaigns
    • Campaigns and Campaign Messages
    • Get All Accounts Campaigns
      POST
    • Publish Messages to Secure Storage
      POST
    • Retrieve Published Messages
      POST
    • Get Campaign Messages Pages
      POST
  1. Customer Groups

Get Customer Groups

POST
https://client-api.dev.nudgescribe.com/v1/cg
ContentCustomer GroupsCustomer GroupCustomersCustomerGet
Retrieves all customer groups within your workspace, providing complete information about your customer segmentation structure.
Enables your application to understand and display the current customer segmentation setup, supporting UI elements like dropdowns, analytics dashboards, and customer assignment interfaces.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠401Unauthorised
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://client-api.dev.nudgescribe.com/v1/cg' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "workspace_id": "your-workspace-id"
}'
Response Response Example
200 - Example 1
[
    {
        "customer_group_id": "your-customer-group-id",
        "workspace_id": "your-workspace-id",
        "group_name": "Tier 5 Customers",
        "created_at": "2025-09-08T18:17:30.444Z",
        "updated_at": "2025-09-08T18:17:30.445Z"
    },
    {
        "customer_group_id": "your-customer-group-id",
        "workspace_id": "your-workspace-id",
        "group_name": "New Prospects",
        "created_at": "2025-09-08T18:17:30.445Z",
        "updated_at": "2025-09-08T18:17:30.446Z"
    }
]
Modified at 2025-09-12 12:53:56
Previous
Create Customer Group
Next
Update Customer Group
Built with