---
title: "Magiq Cloud Data Source"
canonical: "https://help.cartinuum.com/space/GC1/4334125057/Magiq%20Cloud%20Data%20Source"
format: markdown
---
In Connect for ArcGIS, data sources provide connectivity to third-party business systems. The Magiq Cloud API data source allows you to fetch real-time data from [Magiq Cloud](https://magiqcloud.com) (e.g. property, rating, or integration APIs) to display in your ArcGIS web mapping applications.

The data source uses Magiq’s REST APIs with session cookie authentication. You configure an API path and query parameters; map feature attributes (e.g. valuation number, owner email address) can be substituted into the request so that each selected feature retrieves the relevant records from Magiq.

Below is an example layer link configuration that retrieves property records by assessment number from a Magiq integration endpoint.

![image-20260219-233742.png](media://18999f26-a92d-4f15-ab6b-6bb73959974f)

## Data Source Configuration

The Magiq Cloud API data source configuration requires the following: –

- **Customer** – Your Magiq customer identifier (e.g. `lionsville`). This is used for authentication and to form the API base URL `https://{customer}.magiqcloud.com`.

- **Email** – The email address used to sign in to Magiq Cloud for this integration.

- **Password** – The password for that account.

Optional settings: –

- **Timeout (ms)** – How long to wait for each API response before failing (default 10,000 ms).

- **Maximum concurrency** – Maximum number of simultaneous API requests when multiple map features are selected (default 5). Lower values reduce load on Magiq; increase only if needed.

Follow the principle of least privilege when configuring integrations. Use an account that has only the access required for your Connect for ArcGIS application (e.g. read-only access to the integration endpoints you use), not a full administrative login.

## Layer Link Configuration

The Magiq Cloud API layer link configuration includes: –

- **Path** – The API path to call (e.g. `/integration/RG/property_records`). You can use the **[+]** button to insert feature attributes into the path using `{{AttributeName}}` syntax.

- **Query parameters** – One parameter per line in the form `name=value`. Only the first `=` on each line is used to split name and value, so values can contain `=` (e.g. `filter=Valuation={{ValNum}}`). Use the **[+]** button to insert feature attributes into values. For Magiq filter syntax, use a single `filter` parameter with the full expression, e.g. `filter=OccupierEmail="{{Email_Address}}"`.

- **Response JSON path** – The path to the array of records in the JSON response (default `result`). Leave as `result` for standard Magiq integration responses; change only if your endpoint returns a different structure.

- **Test data** (optional) – Sample attribute values for testing the layer link (e.g. `{{ValNum}}=4957` or `{{Email_Address}}=user@example.com`), one per line. Use this to validate the configuration before publishing.

When building query parameters, refer to Magiq’s API or integration documentation for the correct filter format. Errors returned by Magiq (e.g. invalid column names or filter syntax) are shown in Connect for ArcGIS so you can correct the layer link.