# mulesoft Workable Connector - Full Documentation --- product: Workable Connector version: 0.1 is-latest-version: true --- # Workable Connector 0.1.0 > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Anypoint Connector for Workable (Workable Connector) enables Mule applications to access the Workable API. > [!NOTE] Workable Connector is a beta connector that is subject to the Beta Services Terms at > [Agreements - Salesforce.com](https://www.salesforce.com/company/legal/) or a written Unified > Pilot Agreement if executed by Customer, and the Non-GA Gen AI and Non-GA Credit Consumption terms > in the > [Product Terms Directory](https://ptd.salesforce.com/?_ga=2.247987783.1372150065.1709219475-629000709.1639001992). > Use of this beta connector with external systems or services consumes > [Mule messages](https://docs.mulesoft.com/general/usage-metrics) and is at the Customer’s sole discretion. For information about compatibility and fixed issues, refer to the Workable Connector Release Notes. ## Before You Begin To use this connector, you must be familiar with: - The Workable Connector’s API - Anypoint Connectors - Mule runtime engine (Mule) - Elements and global elements in a Mule flow - How to create a Mule app using Anypoint Code Builder or Anypoint Studio Before creating an app, you must have: - Credentials to access the Workable target resource - Anypoint Platform - The latest versions of Anypoint Code Builder or Anypoint Studio ## Next Step After you complete the prerequisites, you’re ready to create an app and configure the connector using [Anypoint Studio](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) or [Anypoint Code Builder](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb). ## See Also - [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Use Exchange to Discover Connectors, Templates, and Examples](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [Workable Connector Reference](https://docs.mulesoft.com/workable-connector/latest/workable-connector-reference) - [Salesforce Help](https://help.salesforce.com) --- product: Workable Connector version: 0.1 is-latest-version: true --- # Workable Connector 0.1.0 Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt ## Configurations ### Config Default configuration. #### Parameters
NameTypeDescriptionDefault ValueRequired

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Name

String

The identifier of this element used to reference it in other components.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform will expire the instance at the exact moment that it becomes eligible. The runtime will actually purge the instances when it sees it fit.

#### Connection Types ##### Bearer Auth Provides access to the Workable API using a bearer token. ###### Parameters
NameTypeDescriptionDefault ValueRequired

baseUri

String

The base URI for the Workable API.

x

token

String

The API key token for authentication.

x

TLS Configuration

The TLS configuration for secure connections.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

## Supported Operations - [addCandidateComment](#AddCandidateComment) - [addCandidateRating](#AddCandidateRating) - [copyCandidateToJob](#CopyCandidateToJob) - [createCandidateForJob](#CreateCandidateForJob) - [createCandidateInTalentPool](#CreateCandidateInTalentPool) - [disqualifyCandidate](#DisqualifyCandidate) - [getAllCandidates](#GetAllCandidates) - [getCandidateActivities](#GetCandidateActivities) - [getCandidateById](#GetCandidateById) - [getCandidateOffer](#GetCandidateOffer) - [moveCandidateToStage](#MoveCandidateToStage) - [revertCandidateDisqualification](#RevertCandidateDisqualification) - [updateCandidate](#UpdateCandidate) - [updateCandidateTags](#UpdateCandidateTags) ## Operations ## addCandidateComment `` Adds a comment to a candidate record. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier associated with the comment.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## addCandidateRating `` Adds a rating to a candidate record. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to rate.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## copyCandidateToJob `` Copies a candidate to a different job. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to copy.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## createCandidateForJob `` Creates a candidate for a specific job. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

shortcode

String

Job shortcode that receives the candidate.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## createCandidateInTalentPool `` Creates a candidate in the talent pool. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## disqualifyCandidate `` Disqualifies a candidate from further consideration. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to disqualify.

x

body

Any

Payload that defines the disqualification details.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

Expression evaluated against the operation output and stored in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Null

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## getAllCandidates `` Retrieves all candidates that meet the provided filter criteria. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

limit

Number

The maximum number of results to return.

since_id

String

Returns candidates created after the specified candidate ID.

max_id

String

Returns candidates created before the specified candidate ID.

created_after

DateTime

Returns candidates created after the specified date and time.

updated_after

DateTime

Returns candidates updated after the specified date and time.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:UNAUTHORIZED ## getCandidateActivities `` Retrieves activity records for a candidate. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier whose activities you want to retrieve.

x

limit

Number

The maximum number of results to return.

offset

Number

Number of activity records to skip before returning results.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED ## getCandidateById `` Retrieves a candidate by identifier. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to retrieve.

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:UNAUTHORIZED ## getCandidateOffer `` Retrieves the offer details for a candidate. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier whose offer you want to retrieve.

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable .

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED ## moveCandidateToStage `` Moves a candidate to a different recruitment stage. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to move.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Null

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## revertCandidateDisqualification `` Reverts a candidate disqualification. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to reinstate.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Null

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED ## updateCandidate `` Updates candidate details. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier to update.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## updateCandidateTags `` Updates tags assigned to a candidate. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

Name of the configuration to use.

x

id

String

Candidate identifier whose tags you want to update.

x

body

Any

The request body content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

### Output

Type

Any

Attributes Type

Any

### For Configurations - [Config](#Config) ### Throws - WORKABLE:BAD\_REQUEST - WORKABLE:CLIENT\_ERROR - WORKABLE:CONNECTIVITY - WORKABLE:FORBIDDEN - WORKABLE:INTERNAL\_SERVER\_ERROR - WORKABLE:NOT\_FOUND - WORKABLE:SECURITY - WORKABLE:SERVER\_ERROR - WORKABLE:TIMEOUT - WORKABLE:TOO\_MANY\_REQUESTS - WORKABLE:UNAUTHORIZED - WORKABLE:UNPROCESSABLE\_ENTITY ## Types ### TLS Configures TLS to provide secure communications for the Mule app.
FieldTypeDescriptionDefault ValueRequired

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Configures the TLS truststore.

Key Store

Configures the TLS keystore.

Revocation Check

Configures a revocation checking mechanism.

### Truststore Configures the truststore for TLS.
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

### Keystore Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the key store.

Algorithm

String

The algorithm used by the key store.

### Standard Revocation Check Configures standard revocation checks for TLS certificates.
FieldTypeDescriptionDefault ValueRequired

Only End Entities

Boolean

Specifies whether to verify only the last element in the certificate chain.

Prefer Crls

Boolean

Specifies whether to check the Certification Revocation List (CRL) first for certificate validity.

No Fallback

Boolean

Specifies whether to avoid using the secondary method to check certificate validity.

Soft Fail

Boolean

Specifies whether to avoid verification failure when the revocation server cannot be reached.

### Custom OCSP Responder Configures a custom OCSP responder for certification revocation checks.
FieldTypeDescriptionDefault ValueRequired

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.

### CRL File Specifies the location of the certification revocation list (CRL) file.
FieldTypeDescriptionDefault ValueRequired

Path

String

Path to the CRL file.

### Reconnection Configures a reconnection strategy for an operation.
FieldTypeDescriptionDefault ValueRequired

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

Reconnection strategy to use.

### Reconnect Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

Specifies how often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread.

Count

Number

Specifies how many reconnection attempts the Mule app can make.

### Reconnect Forever Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

Specifies how often to attempt to reconnect, in milliseconds.

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread.

### Expiration Policy Configures an expiration policy strategy.
FieldTypeDescriptionDefault ValueRequired

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for the Max Idle Time field.

### Error Mapping Defines an error mapping entry.
FieldTypeDescriptionDefault ValueRequired

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

Source of the error.

Target

String

Target of the error.

x