# URL Linking Structure

As an approved integration partner you can create buttons inside your system that link directly to parts of the AutoGrab product suite. This can create valuable user experiences for your customers giving them new abilities to explore datasets outside your platform. 

{% hint style="warning" %}
The "app.autograb.com.au/" prefix applies for most users, consider if your AutoGrab customer audiences use SSO to access the app. If so you may need to dynamically update your prefix like *"example.autograb.com.au/".* 
{% endhint %}

### Real-Time Pricing

At a minimum, a vehicle ID parameter must be included in the URL, as you can see below:\
\
[`https://app.autograb.com.au/pricing?vehicleId=6673067719786496`](https://app.autograb.com.au/pricing?vehicleId=6673067719786496)\
\
You will need to include a rego, vin and/or state parameter to pre-fill the registration search box *without* running a rego lookup. This will associate the pricing record with the correct rego and VIN and enable easy access to PPSR lookups as those details will also be pre-filled:\
\
[`https://app.autograb.com.au/pricing?vehicleId=6673067719786496&rego=CER226&vin=WBATR92040LE26311&state=VIC`](https://app.autograb.com.au/pricing?vehicleId=6673067719786496\&rego=CER226\&vin=WBATR92040LE26311\&state=VIC)\
\
Ideally, the odometer reading should also be passed in the URL, otherwise, it will default to 0kms. You can use the odometer input with or without the rego/vin inputs, but the vehicle ID is always required.\
\
[`https://app.autograb.com.au/pricing?vehicleId=6673067719786496&rego=CER226&vin=WBATR92040LE26311&state=VIC&kms=10000`](https://app.autograb.com.au/pricing?vehicleId=6673067719786496\&rego=CER226\&vin=WBATR92040LE26311\&state=VIC\&kms=10000)\
\
The expected integration pattern assumes your user has access to app.autograb already. If they are not signed in they will be asked to. You can find the vehicle ID by using a v[ehicle search mechanism](https://devhub.autograb.com/nz-autograb-api-doc/vehicle-search) as you would have already done in your product. 

{% hint style="info" %}
This URL strategy will not submit the valuation request, your user will need to push the button.
{% endhint %}

### Sourcing

To jump to a specific vehicle in sourcing you can provide identifiers in the following URL patterns. If the identifier is not able to be matched to a vehicle in sourcing we will notify the user of this in app.

<table><thead><tr><th width="170">Identifier</th><th>URL Example</th></tr></thead><tbody><tr><td>Lead ID</td><td>https://app.autograb.com.au/sourcing<code>/leads/</code>3394e05f-281d-477d-9a4d-3c361307acaf</td></tr><tr><td>VIN</td><td>https://app.autograb.com.au/sourcing<code>?vin=6G1ZX54775L481373</code></td></tr><tr><td>Registration Plate</td><td>https://app.autograb.com.au/sourcing?<code>rego=</code>S075AMU</td></tr></tbody></table>

### MyListings

To jump to a specific vehicle in MyListings you can provide identifiers in the following URL patterns. If you pass in an identifier that is not associated with the logged in dealer we will show an error popup notifying the user of this.&#x20;

<table><thead><tr><th width="170">Identifier</th><th>URL Example</th></tr></thead><tbody><tr><td>Lead ID</td><td>https://app.autograb.com.au/portfolio<code>?lead_id=d0233c61-f4b9-4e3e-87c7-66fca7731005</code></td></tr><tr><td>VIN</td><td>https://app.autograb.com.au/portfolio<code>?vin=7AT0H61YX14006214</code></td></tr><tr><td>Registration Plate</td><td>https://app.autograb.com.au/portfolio<code>?rego=1GAJ330</code></td></tr></tbody></table>