For AI agents: an index of this documentation is at https://developer.rippling.com/llms.txt. Public pages have a Markdown version at the same URL with .md added.

Skip to main content
REST API
API

Create a new site

POST
/sites/

Use with AI:Rippling AI ChatGPT Claude Cursor

Create a new site

POST
/sites/

Create a new site from a staged upload.

  1. Get a presign: POST /sites/upload-batches/presign/ with file_intents (client_ref can be any unique id; file_name is the asset basename, e.g. site.zip).
  2. Upload bytes to S3 using files[].upload_url and files[].upload_fields from the presign response (see POST /sites/upload-batches/presign/).
  3. Create the site: POST /sites/ with application/json including name, api_name, and the returned file_id. Optionally set entry_path when the zip has no index.html.

Required Scopes

  • sites.read-write

Request

Body
    name string

    The display name of the custom site

    description string

    The optional description of the custom site

    api_name string

    The unique api name of the custom site

    logo string

    A Rippling-owned logo URL for the custom site

    entry_path string

    Entry path inside the uploaded asset (for example index.html). Required with file_id when the zip has no index.html.

    file_id string

    Staged upload id from POST /sites/upload-batches/presign/ after uploading bytes to S3. Required to create a site or replace the bundle. The id can be reused for 1 hour from presign, each attach copies the bytes into that site's bundle, a repeat attach before expiry creates another bundle, and the staged object is removed after expiry.

Responses​

Successful response
Schema
    id string

    Identifier field

    name string

    The display name of the custom site

    description string

    The optional description of the custom site

    api_name string

    The unique api name of the custom site

    logo string

    A Rippling-owned logo URL for the custom site

    current_bundle_id string

    The active bundle id for the custom site

    admin_group_id string

    The admin group id for the custom site

    viewer_group_id string

    The viewer group id for the custom site

    created_by string

    The ID of the role that created the custom site

    created_at string

    Record creation date

Loading...