This article lists the Revel API endpoints the iPaaS.com integration uses for employee and timesheet synchronization. It is a reference for firewall allow-listing, API access configuration, troubleshooting, and understanding how data moves between iPaaS.com and Revel. This initial release covers the Employee and Timesheet resources.

Areas covered: Employee · Employee Role Establishment · Timesheet Entry · Connection

Revel exposes a REST API. Each request and response body is JSON.

Revel hosts every customer on their own subdomain, so the base address is specific to your account rather than a shared host. It takes the form:

Throughout this article, [Base URL] stands for your own Revel address — for example, https://acmerestaurants.revelup.com. There is no separate sandbox or production host to choose between; the base address is always your Revel site. Substitute your subdomain wherever [Base URL] appears.

The integration reads employees from Revel when synchronizing them into iPaaS.com, and creates or updates employees in Revel when synchronizing in the other direction.

Retrieves employees from Revel. A filter may be supplied as a query string to narrow the result, and results are returned in pages (see Pagination below).

Retrieves a single employee by their Revel employee ID.

Creates a new employee in Revel.

Updates selected fields on an existing employee, leaving unspecified fields unchanged.

Replaces an existing employee record by ID.

An employee's establishment, role, and hourly wage are held on a separate Revel record rather than on the employee. When those values are supplied during an employee transfer, the integration reads and writes this record as part of the same operation.

Retrieves role and establishment assignments, filtered to a specific employee and establishment.

Creates a new role, establishment, and wage assignment for an employee.

Updates an existing role, establishment, and wage assignment.

The integration reads timesheet entries from Revel when synchronizing them into iPaaS.com, and creates or updates them in Revel when synchronizing in the other direction. In Revel, both a worked-time shift and its break are timesheet entries managed through the same endpoints.

Retrieves timesheet entries from Revel. A filter may be supplied as a query string to narrow the result, and results are returned in pages (see Pagination below).

Retrieves a single timesheet entry by its Revel timesheet entry ID.

Creates a new timesheet entry in Revel.

Updates selected fields on an existing timesheet entry, leaving unspecified fields unchanged.

Replaces an existing timesheet entry by ID.

Retrieves your Revel company record. The integration calls this to verify the connection when you test your credentials; a successful response confirms that the API Url, API Key, and API Secret are valid.

Revel authenticates every request with a single header that carries your API Key and API Secret together, separated by a colon:

iPaaS.com constructs this header from the credentials you enter in the subscription settings, so there is no separate authorization or token endpoint to call, and no OAuth flow to complete. Every request to the endpoints above carries this header. See the Revel Connections and Settings article for how to obtain and enter these credentials.

List endpoints return results in pages. Revel accepts a limit parameter for the number of records per page and an offset parameter for where the page begins, supplied as query-string values on the request. The integration reads successive pages automatically when retrieving records, so no subscriber action is required to page through a large result set.

Revel does not publish a specific request-per-second rate or a numeric daily call figure. Revel does enforce a daily call allowance, and requests that exceed it are rejected until the allowance resets. When that happens, the rejection appears in Dashboard / Integration Monitoring / Error Logs. Because the published limit is unspecified, stagger large transfers rather than running several intensive jobs at the same time.