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
Developer Resources
guide

Permissions for the Developer app

Permissions and profiles for developer tools

Use with AI:Rippling AI ChatGPT Claude Cursor

Overview​

Super admins have access to all Developer app tools. You can also grant access to other users by assigning the system default Developer profile or a custom permission profile with the privileges they need.

What each tool requires​

ToolPermission
OverviewNo extra permission once the Developer app is enabled
Automation StudioNo extra permission once the Developer app is enabled
API TokensCreate and manage API Tokens or Manage the API Tokens app
WebhooksCreate webhooks, or Manage all webhooks
Custom SettingsCreate custom settings or Manage custom settings in the Developer app.
FunctionsCreate functions, Manage functions in the Developer app, or Create custom apps and custom objects
App StudioCreate custom apps and custom objects or Manage all custom apps and custom objects

Permission profiles​

Custom apps creator​

This profile is assigned to every active person when App Manager is enabled and grants access to:

  • Create and manage custom apps
  • Create and manage functions

Developer​

The Permissions app includes a system default profile called Developer which grants access to:

  • Create and manage API Tokens
  • Create webhooks
  • Create custom settings
  • Create functions
  • Create custom apps and custom objects

Users assigned to this profile can manage the items they created. Managing functions, settings, webhooks, API tokens, or apps created by other users requires the manage privileges in Assign access to manage items in the Developer app. Assignees can view the same basic employee data that everyone else can see in Rippling. This profile doesn’t include any other access, and it cannot be modified to grant additional access.

Assign someone to the Developer profile​

  1. From the sidebar, select Company Settings > Permissions.
  2. On the Permission profiles tab, find the Developer profile. It will have a System default tag.
  3. In the Assigned to people column, click the icon to manage the assignees.
  4. Add the individual person or use a Supergroup to dynamically assign the profile to people based on their attributes. For example, to assign the profile to everyone who has the word “developer” in their title, follow these steps:
    1. Select View all attributes.
    2. Select Employment information.
    3. Select Title.
    4. Select a value that contains and type the word “developer.”
    5. Click Insert.
    6. Click Save.

The profile will be assigned to the people you selected.

Note

Users can also request access to the Developer app. These requests are submitted for approval by your company’s super admin. You’ll find them in the Approvals app > Permissions tab. Once approved, the requester is added as an assignee on the system default Developer permission profile.

Assign access to manage items in the Developer app​

  1. From the sidebar, select Company Settings > Permissions.

  2. On the Permission profiles tab, click New permission profile.

  3. Click Start from scratch.

  4. Give the profile a name and a description.

  5. Assign the profile to the person or group of people who need access to manage other people’s work in the Developer app. You can assign individual people or use a Supergroup to assign the profile dynamically based on people’s attributes.

  6. Leave the scope set to the entire company. The scope setting is ignored for this particular privilege, so there’s no need to change it.

  7. Leave Choose specific apps or categories selected, then click Continue.

  8. Next to Rippling apps, click Select app privileges, then select the specific privileges you want assignees to have. To give them access to manage work created by others, include these privileges.

    • Tools > Developer > Manage functions in the Developer app
    • Tools > Developer > Manage custom settings in the Developer app
    • Tools > Developer > Manage all webhooks
    • Tools > Developer > Manage the API tokens app
    Note

    If this person also needs access to create their own functions, settings, etc., you can include those privileges as well.

  9. Click Done.

  10. By default, this profile provides the assignee with access to view only the generally-available data points in Rippling, such as name, title, and manager. If desired, you can give this person access to view additional data about people in Rippling. Next to People data, click Select employee fields, and then select the desired level of data access. Click Done when you're finished.

  11. Click Create permission profile.

Assign access to custom objects as needed​

Permissions are required to view, create, update, or delete custom object data. Grant permission for:

  • People using the Developer app to interact with custom object data
  • API tokens being used to interact with custom object data

For more information, see Object permissions and API tokens.

See also​

In this article: