import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const role = await client.roles.create({
  name: 'order_manager',
  description: 'Handles daily orders',
  permissions: ['write_orders', 'read_customers'],
})

spree api post /roles -d '{"name":"order_manager","description":"Handles daily orders","permissions":["write_orders","read_customers"]}'

{
  "id": "role_gbHJdmfrXB",
  "name": "order_manager",
  "description": "Handles daily orders",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "permissions": [
    "write_orders",
    "read_customers"
  ],
  "mutable": true,
  "users_count": 0
}

{
  "error": {
    "code": "validation_error",
    "message": "Permissions contains unknown permissions: write_bogus and Permissions cannot be granted to a store role: write_bogus",
    "details": {
      "permissions": [
        {
          "code": "role_permissions_unknown",
          "message": "contains unknown permissions: write_bogus",
          "specific": false
        },
        {
          "code": "role_permissions_not_grantable_for_audience",
          "message": "cannot be granted to a store role: write_bogus",
          "specific": false
        }
      ]
    }
  }
}