# Younium

Startdeliver integrates with Younium. Once connected, Younium account and subscription data syncs into Startdeliver customer records automatically. The integration supports multiple legal entities, flexible field mapping, and aggregation across multiple subscriptions per customer — for example summing ARR across all active contracts. Standard setup takes 1 to 2 hours.\
\
**Where to find it:** Apps → Younium **Who can access it:** Admins

***

**What it does**

The Younium integration syncs customer account and subscription data from Younium into Startdeliver. ARR, MRR, contract values, renewal dates, and account details stay current without manual imports. The integration supports multiple legal entities, flexible field mapping, and aggregation across multiple subscriptions per customer.

***

**What syncs**

**Accounts → Customers** Younium accounts sync to customer records in Startdeliver. You control whether records are created only, updated only, or both. You define which field is used to match existing customers between the two systems, and which Younium account fields map to which Startdeliver customer fields — both standard and custom.

Filter which accounts sync by Customer Type and Active status. Only accounts matching your filter rules will sync.

**Subscriptions** Subscription data syncs to the matched customer record. You have full control over which subscriptions are included and what data is pulled from them.

Filter subscriptions by status, version, or date range to sync only the records that matter — for example only active subscriptions, or only the latest version of each contract.

For each customer you can either map fields from a single subscription or aggregate values across multiple subscriptions:

*Single subscription* — map standard fields from one subscription per customer. Useful for straightforward one-contract-per-customer setups.

*Aggregated across multiple subscriptions* — calculate values across all matching subscriptions. Available operations: sum numeric values, find the maximum value, find the minimum value. Common examples: summing ARR across all active subscriptions, finding the longest license length, or identifying the shortest notice period.

***

**Setup**

1. Go to Apps → Younium
2. Authenticate using Client Credentials
3. Select which Legal Entities to sync from
4. Configure Accounts: set sync mode, matching field, filters, and field mapping
5. Configure Subscriptions: set filters, select single or aggregated sync, and map fields
6. Save — the integration runs automatically from this point

***

**Settings reference**

**Sync mode** Controls whether the integration creates new records, updates existing ones, or both. Options: Create only, Update only, Create and Update.

**Matching field** The field used to identify whether a Younium account already exists as a customer in Startdeliver. Common options: HubSpot ID, Company ID, or another unique identifier present in both systems.

**Subscription filters** Narrow which subscriptions are included. Filter by active status, version (latest only), or date range (start or end date falls within a defined period).

**Field mapping — standard fields** Map Younium's standard account and subscription properties to Startdeliver fields. Each mapping row defines a source field in Younium and a destination field in Startdeliver.

**Field mapping — custom fields** Map any custom Younium properties to custom fields in Startdeliver. Requires the corresponding custom field to be created in Startdeliver first.

**Aggregation** When syncing across multiple subscriptions, choose the aggregation method per field: sum, maximum, or minimum. Configure this per field in the subscription mapping.

***

**Troubleshooting**

**A customer or subscription is not showing up as expected**

Check the subscription filter — confirm the subscription matches all filter criteria (active status, latest version flag, date range). A subscription outside the filter window will not sync even if it exists in Younium.

Verify the matching field — confirm the customer identifier (HubSpot ID, Company ID, or whichever field you chose) matches exactly between Younium and Startdeliver. A mismatch means the record won't be found and may be skipped or duplicated depending on your sync mode.

Check effective dates — if using date range filters, confirm the subscription's start or end dates fall within the defined range.

Review sync settings — confirm the sync mode is set to what you expect. If set to Update only and the customer doesn't yet exist in Startdeliver, it won't be created.

Check field mappings — confirm that fields you expect to see populated are mapped under Standard or Custom fields in the configuration.

After making changes, allow one full sync cycle to run before checking results.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.startdeliver.io/integrations-and-your-stack/other-apps/younium.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
