Overview

The OTYS node allows you to connect Flowmage with the OTYS API.

OTYS is commonly used as an ATS (Applicant Tracking System), making this node ideal for:

• Candidate management

• Job applications

• Recruitment workflows

• CRM-style data handling

When to Use This Node

Use the OTYS node when you want to:

• Retrieve candidates or vacancies

• Create or update candidates

• Sync recruitment data with other systems

• Automate hiring workflows

• Integrate OTYS with AFAS, Bullhorn, or other tools

Configuration

Authentication

Authentication Type

API key (login/logout per call)

? Flowmage automatically handles authentication per request.

API Key

Your OTYS API key.

Enter your OTYS API key

Environment Subdomain

Your OTYS environment identifier.

Example:

ows

? This results in:

https://ows.otysapp.com

Request Configuration

Service Name

The OTYS service you want to interact with.

Examples:

• CandidateService

• VacancyService

• ApplicationService

? This defines which data entity you are working with.

Action

Available actions:

• GetList → Retrieve list of records

• getDetail → Retrieve single record

• updateEx → Update existing record

• add → Create new record

• delete → Remove record

Example:

GetList

Params (JSON)

The parameters for your request.

Example:

{  "limit": 10 }

? This is sent as part of the JSON-RPC body.

JSON-RPC Request ID

1

? Returned in the response (useful for batching or debugging)

Request Timeout (ms)

30000

? Maximum time Flowmage waits for a response (default: 30 seconds)

Continue on Error

If enabled:

• Workflow continues even if OTYS call fails

How It Works

1. Flow reaches OTYS node

2. Flowmage authenticates using API key

3. JSON-RPC request is sent

4. OTYS processes the request

5. Response is returned

6. Output becomes available for next nodes

Output / Variables

The OTYS response is available via your Output ID.

Example:

@open.result@

? Example usage:

@open.result[0].firstName@

Example Use Cases

Get Candidates

Service: CandidateService  Action: GetList

Params:

{  "limit": 10 }

Get Candidate Details

Service: CandidateService  Action: getDetail

Params:

{  "id": 12345 }

Create Candidate

Service: CandidateService  Action: add

Params:

{  "firstName": "John",  "lastName": "Doe",  "email": "john@example.com" }

Update Candidate

Service: CandidateService  Action: updateEx

Delete Candidate

Service: CandidateService  Action: delete

Common Mistakes

❌ Wrong Service Name

Using incorrect service.

✅ Always verify available OTYS services

❌ Incorrect Params Structure

JSON format not valid.

✅ Validate JSON before sending

❌ Missing Required Fields

API rejects request.

✅ Check OTYS API documentation per service

❌ Confusing GetList vs getDetail

• GetList → multiple results

• getDetail → single record

Pro Tips

• Use GetList + loops to process candidates

• Combine with AI nodes for candidate scoring

• Use updateEx for partial updates

• Store IDs for later reference

• Use macros to dynamically build params

Summary

The OTYS node allows you to automate recruitment workflows by connecting directly to the OTYS API.

With support for full CRUD operations via JSON-RPC, you can build powerful hiring automations inside Flowmage.

? Next step: Combine OTYS with Bullhorn or AI nodes to create smart recruitment pipelines.