# mulesoft Shippo Connector - Full Documentation --- product: Shippo Connector version: 0.1 is-latest-version: true --- # Shippo Connector 0.1.0 > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Anypoint Connector for Shippo (Shippo Connector) enables Mule applications to access the Shippo API. > [!NOTE] Shippo 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 Shippo Connector Release Notes. ## Before You Begin To use this connector, you must be familiar with: - The Shippo 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 Shippo 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) - [Shippo Connector Reference](https://docs.mulesoft.com/shippo-connector/latest/shippo-connector-reference) - [Salesforce Help](https://help.salesforce.com) --- product: Shippo Connector version: 0.1 is-latest-version: true --- # Shippo 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 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.

#### Connection Types ##### Shippo Token ###### Parameters
NameTypeDescriptionDefault ValueRequired

apiKey

String

The API key for authentication.

x

baseUri

String

The base URI for the Shippo API.

x

TLS Configuration

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 - [createAddress](#CreateAddress) - [createParcel](#CreateParcel) - [createShipment](#CreateShipment) - [createTransaction](#CreateTransaction) - [getShipmentRates](#GetShipmentRates) - [listAddresses](#ListAddresses) ## Operations ## createAddress `` Creates a new address in Shippo. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

body

Any

The address data to create.

#[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 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## createParcel `` Creates a new parcel in Shippo. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

body

Any

The parcel data to create.

#[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 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## createShipment `` Creates a new shipment in Shippo. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

body

Any

The shipment data to create.

#[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 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## createTransaction `` Creates a new transaction in Shippo. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

body

  • Any

  • Any

The transaction data to create.

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 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## getShipmentRates `` Retrieves the available shipping rates for a shipment. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

shipment_id

String

The unique identifier of the shipment.

x

currency_code

String

The currency code for the rates.

Config Ref

ConfigurationProvider

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

x

Target Variable

String

Name of the variable that stores 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:NOT\_FOUND - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## listAddresses `` Retrieves a list of addresses. ### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

page

Number

The page number for pagination.

results

Number

The number of results per page.

Config Ref

ConfigurationProvider

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

x

Target Variable

String

Name of the variable that stores 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 - SHIPPO:BAD\_REQUEST - SHIPPO:CLIENT\_ERROR - SHIPPO:CONNECTIVITY - SHIPPO:FORBIDDEN - SHIPPO:SECURITY - SHIPPO:SERVER\_ERROR - SHIPPO:TIMEOUT - SHIPPO:UNAUTHORIZED ## Types ### Tls
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

Configuration for the trust store.

Key Store

Configuration for the key store.

Revocation Check

Configuration for certificate revocation checking.

### Trust Store
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.

### Key Store
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
FieldTypeDescriptionDefault ValueRequired

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

### Custom Ocsp Responder
FieldTypeDescriptionDefault ValueRequired

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

### Crl File
FieldTypeDescriptionDefault ValueRequired

Path

String

The path to the CRL file.

### Reconnection
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

The reconnection strategy to use.

### Reconnect
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

Blocking

Boolean

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

Count

Number

How many reconnection attempts to make.

### Reconnect Forever
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

Blocking

Boolean

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

### Expiration Policy
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
FieldTypeDescriptionDefault ValueRequired

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

The type of error to map.

Target

String

The target error type to map to.

x