Skip to main content

Setup

Prerequisites

Before making API calls, you need:

  1. A Platzi Business company with a Flexible subscription plan
  2. An API key — requested to the Platzi team

Making Your First Request

Test your credentials by listing company users:

curl "https://api-sls.platzi.com/production-sls-business-domains/v3/users/{company_id}?page=1&page_size=5" \
-H "x-platzi-company-api-key: YOUR_API_KEY" \
-H "User-Agent: YOUR_USER_AGENT"

A successful response returns a paginated list of users with a 200 status code.

Flexible Plans

Most write endpoints (invite, update, resend, validate, bulk-modify) only support companies with Flexible subscription plans. Requests to companies with traditional plans will return:

{
"errors": [
{
"code": "NOT_FLEXIBLE_PLAN",
"message": "Company does not have a flexible plan"
}
]
}

Exception: DELETE /v3/users/{company_id} is plan-type agnostic so that legacy companies whose only plans are non-flexible (typically expired) can still remove their users.

Rate Limits

The API enforces the following rate limits:

LimitThreshold
Per minute400 requests
Per 5-minute window15,000 requests

Bulk operations (invite, update, delete) are processed asynchronously and have a concurrency limit of 100 users processed in parallel.