### Make Authenticated API Request to 7shifts

Source: https://developers.7shifts.com/docs/oauth-authentication

This example shows how to make a GET request to the 'companies' endpoint after obtaining a valid bearer token. It requires the 'x-company-guid' and 'Authorization: Bearer' headers to be included for proper authentication and company-specific data retrieval.

```cURL
url --request GET --url 'https://api.7shifts.com/v2/companies' \
--header 'x-company-guid: {GUID}' \
--header 'Authorization: Bearer {ISSUED_TOKEN}'
```

--------------------------------

### User Data Structure

Source: https://developers.7shifts.com/docs/mapping

Example JSON structure for user data returned by the 7shifts API, highlighting the 'id' field which must be stored for user mapping. It also shows 'active' status.

```JSON
{
    "data": [
        {
            "id": 1111,            
            "active": true...
        },
        {
            "id": 1112,            
            "active": false...
        }
    ],
    "meta": {
        "cursor": {
            "current": "",
            "prev": null,
            "next": null,
            "count": 11
        }
    },
    "object": "users"
}
```

--------------------------------

### Read Employee Data via 7shifts API

Source: https://developers.7shifts.com/docs/employee-sync-overview

This snippet demonstrates how to retrieve employee data and wage assignments from the 7shifts platform. It requires an API key or OAuth token and involves making GET requests to specific API endpoints.

```curl
curl -X GET https://api.7shifts.com/v2/company/{company_id}/users/{user_id} \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

--------------------------------

### Create Receipts via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide covers the process of creating receipts using the 7shifts REST API. It requires an OAuth client and company grant for a 7shifts account. This functionality is part of the Sales Integration.

```bash
curl -X POST \
  https://api.7shifts.com/v3/sales/receipts \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "location_id": 1, \
    "receipt_date": "2023-10-27T00:00:00Z", \
    "total_sales": 1500.75 \
  }'
```

--------------------------------

### OAuth Authentication with 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide covers the OAuth authentication process for the 7shifts API. It requires obtaining an OAuth client and company grant for a 7shifts account to authorize API requests.

```bash
# Step 1: Obtain Authorization Code (User interaction required)
# Redirect user to:
# https://app.7shifts.com/oauth2/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI

# Step 2: Exchange Authorization Code for Access Token
curl -X POST \
  https://app.7shifts.com/oauth2/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=authorization_code&code=AUTHORIZATION_CODE&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&redirect_uri=YOUR_REDIRECT_URI'
```

--------------------------------

### Import Historical Sales Data - Receipt Example

Source: https://developers.7shifts.com/docs/import-historical-sales-data

This JSON example demonstrates how to structure a single receipt object for importing historical sales data. It includes fields like `net_total`, `location_id`, `receipt_date`, `receipt_id`, `receipt_lines`, `tip_details`, and `status`. This format is used when aggregating multiple receipts from a 5-minute interval into one for the historical data push.

```JSON
{
  "net_total": "10000",
  "location_id": "<ID of the location that the receipts are for>",
  "receipt_date": "2021-12-01T10:05:00Z",
  "receipt_id": "<this can be arbitrarily set as it's unlikely this historical data needs updating>"
  "receipt_lines": [],
  "tip_details": [],
  "status": "closed",
}
```

--------------------------------

### Get User Role Assignments

Source: https://developers.7shifts.com/docs/mapping

Fetches the roles assigned to a specific user within a company from the 7shifts API. This is necessary to map users to their respective roles.

```cURL
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users/1111/role_assignments'
```

--------------------------------

### Understanding API Response

Source: https://developers.7shifts.com/docs/read-time-punch-data

Explains how to interpret the data returned in API responses, including an example response.

```text
Understanding the response
Example Response
```

--------------------------------

### Create Sales Receipts with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet demonstrates how to create a sales receipt in the 7shifts platform. It requires an OAuth client ID, client secret, and Company GUID. The process involves making a POST request to the Receipts endpoint.

```bash
curl -X POST \
  'https://api.7shifts.com/v3/company/{company_id}/receipts' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "location_id": 123,
    "receipt_id": "unique_receipt_identifier",
    "receipt_date": "2023-10-27T10:00:00Z",
    "total_sales": 150.75,
    "total_labor": 45.50
  }'
```

--------------------------------

### Retrieve Roles with 7shifts API

Source: https://developers.7shifts.com/docs/labor-integration-overview

This snippet demonstrates how to retrieve a list of roles from the 7shifts API. This is necessary for mapping your system's roles to 7shifts roles. An access token is required for authentication.

```bash
curl -X GET https://api.7shifts.com/v2/roles \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

--------------------------------

### Read Employee Wage Data with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet demonstrates how to fetch an employee's wage data from 7shifts. It requires the Company GUID and the employee ID. This endpoint is essential for payroll and labor cost calculations.

```bash
curl -X GET \
  'https://api.7shifts.com/v3/company/{company_id}/employees/{employee_id}/wages' \
  -H 'Authorization: Bearer {access_token}'
```

--------------------------------

### Create Employee Data via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide details how to create employee data using the 7shifts REST API. It requires an OAuth client and company grant for a 7shifts account. The process involves making API requests to add new employee records.

```bash
curl -X POST \
  https://api.7shifts.com/v3/employees \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "first_name": "John", \
    "last_name": "Doe", \
    "email": "john.doe@example.com", \
    "role_id": 123 \
  }'
```

--------------------------------

### Retrieve Departments with 7shifts API

Source: https://developers.7shifts.com/docs/labor-integration-overview

This snippet shows how to retrieve a list of departments from the 7shifts API. This is essential for mapping your system's departments to 7shifts departments. Authentication with an access token is required.

```bash
curl -X GET https://api.7shifts.com/v2/departments \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

--------------------------------

### Read Employee Data with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet shows how to retrieve employee data from 7shifts. It requires the Company GUID and optionally an employee ID to fetch specific employee details. This is useful for syncing or verifying employee information.

```bash
curl -X GET \
  'https://api.7shifts.com/v3/company/{company_id}/employees/{employee_id}' \
  -H 'Authorization: Bearer {access_token}'
```

--------------------------------

### Labor Totals JSON Payload Example

Source: https://developers.7shifts.com/docs/hours-wages-report

This snippet provides an example of the JSON structure for labor totals, illustrating the various labor metrics and their corresponding values. It includes fields for regular hours and pay, overtime, holiday pay, compliance exceptions, total hours and pay, and different types of tips.

```JSON
"total": {
    "regular_hours": 47,
    "regular_pay": 129,
    "overtime_hours": 11.98,
    "overtime_pay": 74.55,
    "holiday_hours": 0,
    "holiday_pay": 0,
    "compliance_exceptions_pay": 0,
    "total_hours": 58.98,
    "total_pay": 203.55,
    "total_tips": 61.78,
    "cash_tips": 227.14,
    "credit_card_tips": 0,
    "total_payment_tips": 0,
    "pos_declared_tips": 61.78,
    "auto_gratuity": 0,
    "withheld_cc_amount": 0,
    "tip_in": 0,
    "tip_out": 0,
    "earned_tips": 61.78,
    "seven_punches_declared_tips": 61.78
}
```

--------------------------------

### Retrieve Locations with 7shifts API

Source: https://developers.7shifts.com/docs/labor-integration-overview

This snippet demonstrates how to retrieve a list of locations from the 7shifts API. This is useful for mapping your system's locations to 7shifts locations. It requires an access token for authentication.

```bash
curl -X GET https://api.7shifts.com/v2/locations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

--------------------------------

### Daily Sales & Labor Report via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide explains how to generate the Daily Sales & Labor Report using the 7shifts REST API. It requires an OAuth client and company grant, an active POS sales integration, and either 7punches or Actual Labor enabled.

```bash
curl -X GET \
  "https://api.7shifts.com/v3/reports/daily_sales_labor?start_date=2023-10-27&end_date=2023-10-27&location_ids=1" \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

--------------------------------

### Create Time Punch Data via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide explains how to create time punch data using the 7shifts REST API as part of the Labor Integration. It requires an OAuth client and company grant. This allows for recording employee work times.

```bash
curl -X POST \
  https://api.7shifts.com/v3/labor/time_punches \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "employee_id": 12345, \
    "clock_in": "2023-10-27T08:00:00Z", \
    "clock_out": "2023-10-27T16:00:00Z", \
    "location_id": 1 \
  }'
```

--------------------------------

### Verify 7shifts API Access Token

Source: https://developers.7shifts.com/docs/oauth-authentication

This cURL command verifies the validity of an issued access token by calling the 'whoami' endpoint. A successful response will include an 'identify_id' in the payload, confirming the token is active and authorized.

```cURL
curl --request --url GET 'https://api.7shifts.com/v2/whoami' \
--header 'x-company-guid: {GUID}' \
--header 'Authorization: Bearer {ISSUED_TOKEN}'
```

--------------------------------

### Launch 7punches App on Android

Source: https://developers.7shifts.com/docs/7punches-app-switching

This Java code snippet demonstrates how to launch the 7punches application on an Android device using an ACTION_VIEW intent with a custom URI scheme. It includes error handling for cases where the 7punches app is not installed or cannot be found.

```Java
try {
    startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse("sevenshifts://punch")));
} catch (ActivityNotFoundException e) {
    // Activity can not be found to execute the given Intent
}
```

--------------------------------

### Get Employee Wages - 7shifts API

Source: https://developers.7shifts.com/docs/read-employee-wage-data

This snippet demonstrates how to make a GET request to the 7shifts API's /wages endpoint to retrieve wage data for a specific user. It shows the request URL structure and provides example responses.

```cURL
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users/1111/wages'
```

```JSON
{
    "data": {
        "current_wages": [
            {
                "id": 6494898,
                "effective_date": "2020-12-01",
                "role_id": null,
                "wage_type": "weekly_salary",
                "wage_cents": 120000,
                "created": "2020-12-01T15:32:23Z",
                "modified": "2020-12-01T15:32:23Z"
            },
            {
                "id": 6488058,
                "effective_date": "2019-10-28",
                "role_id": 1004823,
                "wage_type": "hourly",
                "wage_cents": 1700,
                "created": "2019-10-28T14:40:37Z",
                "modified": "2019-10-28T14:40:37Z"
            }
        ],
        "upcoming_wages": []
    },
    "object": "user_wages"
}
```

```JSON
{
    "data": {
        "current_wages": [
            {
                "id": 6494898,
                "effective_date": "2020-12-24",
                "role_id": null,
                "wage_type": "hourly",
                "wage_cents": 1200,
                "created": "2020-12-24T15:32:23Z",
                "modified": "2020-12-24T15:32:23Z"
            },
            {
                "id": 6488058,
                "effective_date": "2020-12-24",
                "role_id": 1004823,
                "wage_type": "hourly",
                "wage_cents": 1700,
                "created": "2020-12-24T14:40:37Z",
                "modified": "2020-12-24T14:40:37Z"
            },
            {
                "id": 6488059,
                "effective_date": "2020-12-24",
                "role_id": 1004835,
                "wage_type": "hourly",
                "wage_cents": 1500,
                "created": "2020-12-24T14:40:37Z",
                "modified": "2020-12-24T14:40:37Z"
            }
        ],
        "upcoming_wages": []
    },
    "object": "user_wages"
}
```

--------------------------------

### Create Employee Data via 7shifts API

Source: https://developers.7shifts.com/docs/employee-sync-overview

This snippet demonstrates how to create new employee data and assignments in the 7shifts platform. It requires an API key or OAuth token and involves making POST requests to specific API endpoints.

```curl
curl -X POST https://api.7shifts.com/v2/company/{company_id}/users \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ \
    "first_name": "John", \
    "last_name": "Doe", \
    "email": "john.doe@example.com", \
    "phone": "123-456-7890", \
    "status": "active", \
    "role_id": 123, \
    "department_id": 456, \
    "location_id": 789 \
  }'
```

--------------------------------

### Get Company Departments

Source: https://developers.7shifts.com/docs/mapping

Retrieves a list of all departments within a specified company from the 7shifts API. This is used to populate dropdowns for department mapping.

```cURL
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/departments'
```

--------------------------------

### Manage Employment Records via 7shifts API

Source: https://developers.7shifts.com/docs/employee-sync-overview

This snippet outlines the process for managing employment records for employees within the 7shifts platform. It requires an API key or OAuth token and involves interacting with specific API endpoints for employment record management.

```curl
curl -X POST https://api.7shifts.com/v2/company/{company_id}/users/{user_id}/employment_records \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ \
    "start_date": "2023-01-01", \
    "end_date": null \
  }'
```

--------------------------------

### Get Company Users

Source: https://developers.7shifts.com/docs/mapping

Retrieves a list of all active users within a specified company from the 7shifts API. This is essential for user mapping and populating the UI.

```cURL
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users'
```

--------------------------------

### Fetch First 50 Users (cURL)

Source: https://developers.7shifts.com/docs/read-employee-data

This cURL command retrieves the first 50 users matching specified criteria. The 'limit' parameter controls the number of results per page. The response includes cursor information for pagination.

```bash
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users?limit=50'
```

--------------------------------

### Get Company Roles

Source: https://developers.7shifts.com/docs/mapping

Fetches a list of all roles within a specified company from the 7shifts API. This data is used for populating the 7shifts roles dropdown during role mapping.

```cURL
curl --reuest GET --url 'https://api.7shifts.com/v2/company/1234/roles'
```

--------------------------------

### Create Employee Data with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet demonstrates how to create new employee data within the 7shifts platform. It requires essential employee details such as first name, last name, and email. This is part of the Employee Sync integration.

```bash
curl -X POST \
  'https://api.7shifts.com/v3/company/{company_id}/employees' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "role_id": 5
  }'
```

--------------------------------

### Get 7shifts Locations

Source: https://developers.7shifts.com/docs/mapping

Retrieves a list of all locations within a specified 7shifts company. This is useful for implementing location mapping features in your integration, allowing users to associate their system's locations with corresponding 7shifts locations.

```cURL
curl --request GET --url https://api.7shifts.com/v2/company/1234/locations
```

--------------------------------

### Update Time Punch to Record Break End

Source: https://developers.7shifts.com/docs/update-time-punch-data

This example shows the cURL command to update a time punch record when an employee returns from a break. It requires a PUT request to the same endpoint as starting a break, with the addition of the 'breaks.out' field.

```curl
curl --request PUT --url 'https://api.7shifts.com/v2/company/1234/time_punches/1'
```

--------------------------------

### Send Detailed Receipt with Line Items and Tip Details

Source: https://developers.7shifts.com/docs/sales-integration-create-receipts

This example demonstrates how to structure a JSON payload to send a complete receipt to the 7shifts API. It includes both `receipt_lines` for individual item details and `tip_details` for tip breakdowns, adhering to the API's requirements for accurate sales data.

```JSON
{
  "receipt_id": "rec_98765",
  "location_id": 7890,
  "receipt_date": "2022-05-01T13:36:52Z",
  "net_total": 5990,
  "gross_total": 7150,
  "total_receipt_discounts": 1160,
  "tips": 1160,
  "external_user_id": "a4355",
  "revenue_center": "828d",
  "order_type": "DINE_IN",
  "status": "closed",
  "dining_option": "fbe1b33f0b11",
  "receipt_lines": [
    {
      "external_category_ids": [
        "02a7-41b3"
      ],
      "external_item_id": "fa6e064bc2e2",
      "quantity": 5,
      "price": 430,
      "gross_item_price": 600,
      "net_item_price": 430,
      "item_discount": 0,
      "status": "closed",
      "created": "2022-05-01T13:36:55Z"
    },
    {
      "external_item_id": "c9b91da6648a",
      "quantity": 10,
      "price": 3900,
      "gross_item_price": 4655,
      "net_item_price": 3900,
      "item_discount": 0,
      "status": "closed",
      "created": "2022-05-01T13:36:55Z"
    }
  ],
  "tip_details": [
    {
      "type": "total",
      "value": 1160
    },
    {
      "type": "gratuity",
      "value": 0
    }
  ]
}
```

--------------------------------

### Get Bearer Token for 7shifts API

Source: https://developers.7shifts.com/docs/oauth-authentication

This snippet demonstrates how to obtain a bearer token for making API requests to 7shifts. It requires a grant type, client ID, client secret, and the desired scopes. Bearer tokens expire after one hour.

```cURL
curl --request POST --url 'https://app.7shifts.com/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={CLIENT_ID}' \
--data-urlencode 'client_secret={CLIENT_SECRET}' \
--data-urlencode 'scope=v1_access {ADDITIONAL_SCOPES}'
```

--------------------------------

### Update Employee Email via PUT Request (Conditional)

Source: https://developers.7shifts.com/docs/update-employee-data

This example shows how to update an employee's email address. It includes a prerequisite GET request to check if the email field is empty before proceeding with the PUT request, ensuring data integrity.

```curl
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users/1111'
```

```json
{
     "first_name": "Bertram",
     "last_name": "Gilfoyle",
     "mobile_number": "3065558888",
     "email": "bertie.gilfoyle@piedpiper.com"
}
```

--------------------------------

### Generate Company Grant URL with State Parameter - 7shifts API

Source: https://developers.7shifts.com/docs/oauth-authentication

This URL initiates the OAuth 2.0 company grant process and includes a 'state' parameter to prevent CSRF attacks and maintain application state. Replace {CLIENT_ID} with your OAuth client ID and {PARTNER_PROVIDED_STRING} with your custom state identifier.

```text
https://app.7shifts.com/generate_token?client_id={CLIENT_ID}&state={PARTNER_PROVIDED_STRING}
```

--------------------------------

### Check for Scheduled Shifts via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide explains how to check for scheduled shifts using the 7shifts REST API. It requires an OAuth client and company grant. This functionality is part of the Schedule Enforcement guide.

```bash
curl -X GET \
  "https://api.7shifts.com/v3/schedules?location_id=1&start_date=2023-10-27&end_date=2023-10-27" \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

--------------------------------

### Check Per-Role Wage Support (cURL)

Source: https://developers.7shifts.com/docs/create-employee-data

This snippet demonstrates how to make a GET request to the 7shifts API to retrieve company information. The response will indicate whether the 'wage_based_roles_enabled' feature is active, which is crucial for setting per-role wages for employees.

```bash
curl --request GET  --url 'https://api.7shifts.com/v2/companies'
```

--------------------------------

### Create Receipts for Tip Pools

Source: https://developers.7shifts.com/docs/automatic-tip-pool-contributions

This snippet demonstrates how to structure receipt data to include information necessary for automatic tip pool contributions. It highlights key parameters like `net_total`, `receipt_date`, and `location_id` which are crucial for allocating sales and tips to employees.

```json
{
  "net_total": 10000, 
  "receipt_date": "2023-10-27T10:00:00Z", 
  "location_id": 123,
  "receipt_lines": [
    {
      "net_item_price": 5000,
      "external_category_ids": ["liquor"]
    }
  ]
}
```

--------------------------------

### Check for Scheduled Shifts with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet shows how to check for scheduled shifts for a given period using the 7shifts API. It requires the Company GUID and date parameters. This is part of the Schedule Enforcement integration.

```bash
curl -X GET \
  'https://api.7shifts.com/v3/company/{company_id}/schedules?start_date=2023-10-27&end_date=2023-10-28' \
  -H 'Authorization: Bearer {access_token}'
```

--------------------------------

### Update Sales Receipts with 7shifts API

Source: https://developers.7shifts.com/docs/sales-integration-overview

This snippet shows how to update an existing sales receipt in 7shifts. It requires the Company GUID and the specific receipt identifier. Updates are reflected asynchronously and may take up to 5 minutes.

```bash
curl -X PUT \
  'https://api.7shifts.com/v3/company/{company_id}/receipts/{receipt_id}' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "total_sales": 160.50,
    "total_labor": 48.00
  }'
```

--------------------------------

### Create/Update Wage Data via 7shifts API

Source: https://developers.7shifts.com/docs/employee-sync-overview

This snippet demonstrates how to create or update wage assignment data for employees in the 7shifts platform. It requires an API key or OAuth token and involves making POST requests to the User Wages endpoint.

```curl
curl -X POST https://api.7shifts.com/v2/company/{company_id}/users/{user_id}/wages \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ \
    "wage_amount": 15.50, \
    "wage_type": "hourly", \
    "role_id": 123 \
  }'
```

--------------------------------

### Read Employee Wage Data via 7shifts API

Source: https://developers.7shifts.com/docs/overview-1

This guide explains how to read employee wage data using the 7shifts REST API. It requires an OAuth client and company grant. This allows retrieval of an employee's wage information.

```bash
curl -X GET \
  https://api.7shifts.com/v3/employees/12345/wages \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

--------------------------------

### Create Employment Record (POST)

Source: https://developers.7shifts.com/docs/manage-employment-records

Adds a new employment record for an employee or contractor, including their hire date and classification. The classification defaults to 'employee' if not specified.

```curl
curl --request POST --url 'https://api.7shifts.com/v2/company/12345/employment_records'
```

```json
{
  "user_id": 67890,
  "hire_date": "2023-01-15",
  "classification": "employee"
}
```

--------------------------------

### Fetch Next 50 Users (cURL)

Source: https://developers.7shifts.com/docs/read-employee-data

This cURL command fetches the next set of 50 users by utilizing the 'next' cursor obtained from a previous response. This is crucial for iterating through paginated data.

```bash
curl --request GET -url 'https://api.7shifts.com/v2/company/1234//users?cursor=eyJpZCI6Ijg2MDIzMDM2IiwibmV4dCI6dHJ1ZX0='
```

--------------------------------

### Get User Assignments via API

Source: https://developers.7shifts.com/docs/read-employee-data

This snippet demonstrates how to retrieve user assignment data for a specific user within a company using the 7shifts API. It utilizes a GET request to the '/v2/company/{companyId}/users/{userId}/assignments' endpoint.

```cURL
curl --request GET --url 'https://api.7shifts.com/v2/company/1234/users/1111/assignments'
```

--------------------------------

### Create Employee Wage Data

Source: https://developers.7shifts.com/docs/create-employee-data

This cURL request demonstrates how to create an employee profile in 7shifts and simultaneously set their wage data. The request body specifies the role, wage type (hourly or weekly salary), wage amount in cents, and the effective date for the wage.

```cURL
curl --request POST --url 'https://api.7shifts.com/v2/company/12345/users/1111/wages'
```

```JSON
{
     "role_id": 1029,
     "wage_type": "hourly",
     "wage_cents": 2300,
     "effective_date": "2022-06-01"
}
```

--------------------------------

### Create Employee - cURL Request

Source: https://developers.7shifts.com/docs/create-employee-data

This snippet shows the cURL command to send a POST request to the /users endpoint for creating a new employee in 7shifts. It includes the target URL.

```cURL
curl --request POST --url 'https://api.7shifts.com/v2/company/1234/users'
```

--------------------------------

### Create External User Mappings Bulk - cURL

Source: https://developers.7shifts.com/docs/automatic-tip-pool-contributions

This cURL command demonstrates how to use the bulk endpoint to map multiple external user IDs to 7shifts user IDs. It includes various ways to identify users, such as user ID, email, or name and phone number.

```cURL
curl --request POST --url 'https://api.7shifts.com/v2/company/12345/location/7890/external_user_mappings_bulk'
--data '{
    "data": [
        {
            "external_user_id": "Shawna1234ExID",
            "user_id": 1235,
        },
        {
            "external_user_id": "Johnny1234ExID",
            "email": "demo@test.com",
        },
        {
            "external_user_id": "Star234ExID",
            "first_name": "Jane",
            "last_name": "Star",
            "phone_number": "309939393"
        },
				{
            "external_user_id": "bc5234ExID",
            "first_name": "Bob",
            "last_name": "Carr",
        }
    ]
}'
```