# mulesoft Bird Connector - Full Documentation --- product: Bird Connector version: 1.1 is-latest-version: true --- # Bird Connector 1.1 > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Anypoint Connector for Bird (Bird Connector) enables Mule applications to access the Bird API. For information about compatibility and fixed issues, refer to the Bird Connector Release Notes. ## Before You Begin To use this connector, you must be familiar with: - The Bird 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 Bird 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) - [Bird Connector Reference](https://docs.mulesoft.com/bird-connector/latest/bird-connector-reference) - [Salesforce Help](https://help.salesforce.com) --- product: Bird Connector version: 1.1 is-latest-version: true --- # Bird Connector 1.1 Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt ## Configurations --- ### Config Default configuration. #### Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
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 Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate. |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
apiKey | String | API key used to authenticate requests to the Bird API. | x | |
baseUri | String | Base URI for the Bird API. | x | |
TLS Configuration | Configures TLS for the connection. | |||
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. |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
contactId | String | ID of the contact. | 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’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. |
Type | Null |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | 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’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. |
Type | Null |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
messageId | String | ID of the message. | 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’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. |
Type | Null |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
channelId | String | ID of the channel. | 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’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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
channelId | String | ID of the channel. | x | |
messageId | String | ID of the message. | 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’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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
contactId | String | ID of the contact. | 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’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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | 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’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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
messageId | String | ID of the message. | 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’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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
channelId | String | ID of the channel. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
status | Enumeration, one of:
| Status used to filter channel messages. | ||
emailSubject | String | Email subject used to filter channel messages. | ||
startAt | DateTime | Start date and time used to filter channel messages. | ||
endAt | DateTime | End date and time used to filter channel messages. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
search | String | Search text used to filter contacts. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
reverse | Boolean | Whether to return messages in reverse order. | false | |
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
resource | String | Resource used to filter conversations. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
limit | Number | Maximum number of results to return. | ||
pageToken | String | Token for pagination to retrieve the next page of results. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | x | |
Streaming Strategy |
| Configures how Mule processes streams. Repeatable streams are the default behavior. | ||
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. |
Type | Array of Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
channelId | String | ID of the channel. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
contactId | String | ID of the contact. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
workspaceId | String | ID of the workspace. | x | |
conversationId | String | ID of the conversation. | x | |
messageId | String | ID of the message. | x | |
body | Any | Request body for the operation. | #[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. |
Type | Any |
Attributes Type | Any |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
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 trust store for TLS certificate validation. | |||
Key Store | Configures the key store for client authentication. | |||
Revocation Check | Configures certificate revocation checking. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The location, 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 are performed, which makes connections vulnerable to attacks. Use at your own risk. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The location, 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 to use. If not defined, the first key in the file is 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. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Only End Entities | Boolean | Verifies only the last element of the certificate chain. | ||
Prefer Crls | Boolean | Tries CRL instead of OCSP first. | ||
No Fallback | Boolean | Does not use the secondary checking method, which is the method not selected before. | ||
Soft Fail | Boolean | Avoids verification failure when the revocation server cannot be reached or is busy. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Url | String | The URL of the OCSP responder. | ||
Cert Alias | String | Alias of the signing certificate for the OCSP response, which must be in the trust store, if present. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The path to the CRL file. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
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 | The reconnection strategy to use. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency | Number | How often, in milliseconds, to reconnect. | ||
Blocking | Boolean | If false, the reconnection strategy runs in a separate, nonblocking thread. | ||
Count | Number | How many reconnection attempts to make. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency | Number | How often, in milliseconds, to reconnect. | ||
Blocking | Boolean | If false, the reconnection strategy runs in a separate, nonblocking thread. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Max Idle Time | Number | A scalar time value for the maximum amount of time that a dynamic configuration instance can remain idle before it’s considered eligible for expiration. | ||
Time Unit | Enumeration, one of:
| A time unit that qualifies the |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Source | Enumeration, one of:
| Error type to map. | ||
Target | String | Error type to which the source error is mapped. | x |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Initial Buffer Size | Number | The number of instances initially allowed in memory to consume the stream and provide random access to it. If the stream contains more data than fits in this buffer, the buffer expands according to the | ||
Buffer Size Increment | Number | The amount by which the buffer size expands if it exceeds its initial size. A value of zero or less prevents the buffer from expanding, which raises a | ||
Max Buffer Size | Number | The maximum amount of memory to use. If more memory is used, a |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
In Memory Objects | Number | The maximum number of instances to keep in memory. If more are required, the content is buffered on disk. | ||
Buffer Unit | Enumeration, one of:
| The unit in which |