Confirm Column Mappings
confirm_column_mappingsConfirm column mappings for a staged matched-segment upload, starting identity resolution. Call this after analyze_audience_upload has been reviewed with the user and they approve (with or without edits). This moves the staged file into place — nothing runs before this call succeeds. Only call wait_for_segment after this returns ok. Pass exactly one of segment_id or audience_id — use audience_id when only the audience is known (it resolves to that audience's matched member segment server-side). When using audience_id, column_mappings is required (no auto-inference fallback on that path). When using segment_id, column_mappings may be omitted — the platform re-analyzes the active upload itself and accepts its own suggested mapping as-is. Async build completion or failure may notify configured external webhooks and opted-in users by email. Requires 'creator' scope.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "confirm_column_mappings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| segment_id | No | The segment_id returned by create_segment(subtype=matched) | |
| audience_id | No | The audience_id, if segment_id isn't known | |
| column_mappings | No | Map of source column name -> standard identity attribute name. Valid targets: iag_person_id, full_name, first_name, middle_name, last_name, name_suffix, address_1, address_2, city, state, zip, email, phone, dob, email_sha256, phone_sha256, emails, phones, addresses, emails_sha256, phones_sha256 (the last 7 — hashed/plural/array variants — are LLM/programmatic mapping targets only, not offered in a human dropdown). Use "(skip)" to exclude a column. For segment_id: omit to have the platform accept its own fresh analysis of the upload as-is. For audience_id: required. Always send the FULL mapping set (not just user-edited columns); this replaces the mappings entirely rather than merging. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the requested action succeeded | |
| guidance | No | Interpretation or recovery guidance for this result | |
| count_unit | No | ||
| page_count | No | Number of objects on this page, not the organization total | |
| count_state | No | Unknown means no count; available does not guarantee freshness. Recount for a current value. | |
| next_actions | No | Suggested next calls using returned IDs and available scopes. Not executed and not user consent. | |
| column_mappings | Yes | ||
| population_input | No | Population input used for the preview; IDs refer to their current saved definitions |