--- title: Creating Google Workspace Users via Siit Webhook description: Creating Google Workspace Users via Siit Webhook --- [Skip to content](https://help.siit.io/webhook-google-workspace-users#main-content) [![Logo\_Siit\_Full\_White](https://help.siit.io/hs-fs/hubfs/Logo_Siit_Full_White.png?width=70&height=33&name=Logo_Siit_Full_White.png)](https://help.siit.io/?hsLang=en) - [Help Center](https://help.siit.io/) - [Docs](https://docs.siit.io/) - [API reference](https://developer.siit.io/api-reference/authentication) - [Changelog](https://www.siit.io/changelog) Open main navigation Close main navigation - [Help Center](https://help.siit.io/) - [Docs](https://docs.siit.io/) - [API reference](https://developer.siit.io/api-reference/authentication) - [Changelog](https://www.siit.io/changelog) How can we help? - There are no suggestions because the search field is empty. 1. [Help center](https://help.siit.io/?hsLang=en) 2. [Automations and Workflows](https://help.siit.io/automations-and-workflows?hsLang=en) 3. [Use cases](https://help.siit.io/automations-and-workflows?hsLang=en#use-cases) # Creating Google Workspace Users via Siit Webhook ## Seamlessly Provision Users with Siit Webhooks and the Google Directory API. Connecting your Siit workflows to **Google Workspace** allows you to automate user provisioning, ensuring that new employees are ready to go as soon as their Siit lifecycle event triggers. ### Prerequisites: Google Workspace Setup Before configuring the webhook in Siit, you need to set up the Google Workspace Directory API. This step ensures Siit has permission to create users. 1. **Enable the Admin SDK:** In your Google Cloud project, enable the **Admin SDK API** (specifically for the Directory API). 2. **Authentication:** The Google Directory API requires an **OAuth 2.0 token** for authorization. The most secure and common method for server-to-server workflows is using a **Service Account** with **Domain-Wide Delegation** enabled. - Once set up, your workflow (or an intermediary service) must be able to generate and provide a valid **Bearer Token** for the `Authorization` header. 3. **API Endpoint:** The specific URL for creating a user is: ``` https://admin.googleapis.com/admin/directory/v1/users ``` For full details on the required fields and response structure, consult the official Google documentation for the `users.insert` method: [Directory API: Users Insert](https://developers.google.com/workspace/admin/directory/reference/rest/v1/users/insert). --- ### 🛠️ Siit Webhook Configuration Using the **"Send external request"** action in your Siit workflow, follow these steps to construct the request. ### ![](https://help.siit.io/hs-fs/hubfs/CleanShot%202026-01-18%20at%2014-27-04@2x-png.png?width=1880&height=1784&name=CleanShot%202026-01-18%20at%2014-27-04@2x-png.png) ### Step 1: Set the URL and Method In the **Send external request** panel (as shown in your screenshot): 1. **URL:** Enter the Google API endpoint: ``` https://admin.googleapis.com/admin/directory/v1/users ``` 2. **HTTP Method:** Select **POST** (this is mandatory for creating a new resource). ### Step 2: Add Headers You need to add at least two headers: one for the data format and one for authentication. Click **+ Add header**. | Header Name | Value | Description | | --- | --- | --- | | **Content-Type** | `application/json` | Tells the Google API to expect a JSON payload. | | **Authorization** | `Bearer [YOUR_ACCESS_TOKEN]` | Replace `[YOUR_ACCESS_TOKEN]` with the valid OAuth 2.0 Bearer token obtained from your Google setup. | Step 3: Construct the JSON Body Select the **Raw** option under the **Body** section. You will use the available Siit variables (from the "Add variable" sidebar) to dynamically populate the user data required by the Google API. The Google API requires a minimum set of fields, including the primary email, the user's name, and a temporary password. Use the **+ Add variable** button to inject the variable placeholders directly into the **Raw** text field.   **Example Raw JSON Body:** JSON   ``` { "primaryEmail": "{Email}", "name": { "givenName": "{First name}", "familyName": "{Last name}" }, "password": "[SOME_TEMPORARY_PASSWORD]", "changePasswordAtNextLogin": true, "suspended": false} ``` *⚠️ when copy pasting the script, make sure to replace **Email, First name and Last name** with the corresponding Siit requester variable clicking on **"+ Add variable"** as per the screenshot below:*  ![](https://help.siit.io/hs-fs/hubfs/CleanShot%202026-01-18%20at%2014-31-01@2x-png-1.png?width=2462&height=1784&name=CleanShot%202026-01-18%20at%2014-31-01@2x-png-1.png) #### Variable Mapping Checklist: | Google API Field | Siit Variable | Notes | | --- | --- | --- | | `primaryEmail` | `{Email}` | Maps to the employee's email address. | | `name.givenName` | `{First name}` | Maps to the employee's first name. | | `name.familyName` | `{Last name}` | Maps to the employee's last name. | | `password` | Static Value | **Important:** You must set a temporary password. Use a secure static value or generate one in your workflow if possible. | | `changePasswordAtNextLogin` | `true` | Recommended for security. |   By completing these steps, when your Siit workflow is triggered (e.g., when a new employee's status changes to "Active" on the start date), the webhook will fire, sending the necessary employee data to Google to create their Workspace account automatically. ✅ Done! Siit now adds users automatically to Google Workspace. - [Getting started](https://help.siit.io/getting-started?hsLang=en#main-content) - [For Admins](https://help.siit.io/getting-started?hsLang=en#for-admins) - [Employee Guides](https://help.siit.io/getting-started?hsLang=en#employee-guides) - [Request and Service Management](https://help.siit.io/request-and-service-management?hsLang=en#main-content) - [Request](https://help.siit.io/request-and-service-management?hsLang=en#request) - [Email](https://help.siit.io/request-and-service-management?hsLang=en#email) - [Service catalog](https://help.siit.io/request-and-service-management?hsLang=en#service-catalog) - [SLAs](https://help.siit.io/request-and-service-management?hsLang=en#slas) - [App access](https://help.siit.io/request-and-service-management?hsLang=en#app-access) - [AI & Agents](https://help.siit.io/ai-agents?hsLang=en#main-content) - [Overview](https://help.siit.io/ai-agents?hsLang=en#overview) - [Setup](https://help.siit.io/ai-agents?hsLang=en#setup) - [Use cases](https://help.siit.io/ai-agents?hsLang=en#use-cases) - [Automations and Workflows](https://help.siit.io/automations-and-workflows?hsLang=en#main-content) - [Getting started](https://help.siit.io/automations-and-workflows?hsLang=en#getting-started) - [Use cases](https://help.siit.io/automations-and-workflows?hsLang=en#use-cases) - [Integrations](https://help.siit.io/automations-and-workflows?hsLang=en#integrations) - [Reporting and Analytics](https://help.siit.io/reporting-and-analytics?hsLang=en) - [Integrations](https://help.siit.io/integrations?hsLang=en#main-content) - [Communication](https://help.siit.io/integrations?hsLang=en#communication) - [HRIS](https://help.siit.io/integrations?hsLang=en#hris) - [Ticketing](https://help.siit.io/integrations?hsLang=en#ticketing) - [Knowledge base](https://help.siit.io/integrations?hsLang=en#knowledge-base) - [Identity Provider](https://help.siit.io/integrations?hsLang=en#identity-provider) - [Device Management](https://help.siit.io/integrations?hsLang=en#device-management) - [Knowledge Base Management](https://help.siit.io/knowledge-base-management?hsLang=en) - [Admin, Security & Workspace](https://help.siit.io/admin-security-workspace?hsLang=en#main-content) - [Workspace Settings](https://help.siit.io/admin-security-workspace?hsLang=en#workspace-settings) - [SSO (SAML)](https://help.siit.io/admin-security-workspace?hsLang=en#sso-saml) - [SCIM & Provisioning](https://help.siit.io/admin-security-workspace?hsLang=en#scim-provisioning) - [People & Directory](https://help.siit.io/admin-security-workspace?hsLang=en#people-directory) [![Siit\_Logo\_Dark](https://help.siit.io/hs-fs/hubfs/Siit_Logo_Dark.png?width=140&height=67&name=Siit_Logo_Dark.png "Siit_Logo_Dark")](http://siit.io) Copyright © 2025, Siit SAS