# Onshape to ION

## Getting started

Follow the instructions below to automatically sync data from [onshape](https://docs.violetlabs.com/apps/o/onshape "mention") to [ion](https://docs.violetlabs.com/apps/i/ion "mention"):

{% stepper %}
{% step %}

### Create an <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FFibhck3vD1NE3JphISWn%2Fonshape.png?alt=media&#x26;token=6ba626bf-6493-4d65-a308-24bd3e217f65" alt="" data-size="line"> Onshape integration

First, create an Onshape integration following the instructions [here](https://docs.violetlabs.com/apps/a/arena). Configure your data fetch, specifying:

* The types of data you want to fetch (`parts`, `files`, etc).
* Fetch frequency - either via webhooks, which enables an event-driven sync (this is recommended due to Onshape's API limits), or scheduled - for example every 1 hour, 10 minutes, etc.

Violet enables automatic ingestion (and syncing) of Onshape `files` . By default, this includes 2D part drawings (.pdf) and 3D models (.stp). If you are interesting in fetching or syncing other file types, reach out and let us know.
{% endstep %}

{% step %}

### Create an <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FjEUUf71xOyb4XakXE8Lw%2Fion.png?alt=media&#x26;token=b2154d3d-d7c2-49fe-b327-405feddc422e" alt="" data-size="line"> **ION** integration

Next, set up an ION integration, following the instructions [here](https://docs.violetlabs.com/apps/i/ion/generate-api-credentials-in-ion). Configure your data fetch, specifying:

* The types of data you want to fetch (`parts`, `runs`, `purchase orders`, etc).
* Fetch frequency - this is either scheduled, eg. every 1 hour, 10 minutes, etc., or event-driven via webhooks.

Violet will need to fetch whichever data you wish to be synced from Onshape (eg. `parts`).
{% endstep %}

{% step %}

### Configure sync workflow

Head to [..](https://docs.violetlabs.com/features/workflows "mention") to configure your sync, including desired trigger, property mappings, business logic, etc.
{% endstep %}
{% endstepper %}

## Observability

To learn more about monitoring performance and health & status of your data syncs, head to [observability](https://docs.violetlabs.com/features/workflows/observability "mention").

<p align="center"><em>Violet Labs is a proud member of the</em> <a href="https://cad.onshape.com/appstore/apps/Project%20&#x26;%20Data%20Management/68e58a98da73921b0d3c0543"><em>Onshape Partner Program</em></a><em>.</em></p>

<p align="center"><em>Looking for Onshape integration functionality you don't see listed here? Reach out to us at</em> <a href="mailto:hello@violetlabs.com"><em>hello@violetlabs.com</em></a><em>.</em></p>
