API-first onboarding data cleanup

Messy data in. Clean records out.

Your customers upload their spreadsheets — or even a photo of one — right inside your product. Transmutify's API normalizes the data, a human approves it in a hosted review, and your clients onboard themselves.

Bring your own AI keys
Bring your own storage
PII-safe file mapping
Webhook secret verification
Dry-run without provider calls

Faster go-live

Turn customer spreadsheets into import-ready records without manual cleanup queues.

Self-serve onboarding

Clients stay inside your product while reviewers approve the hosted handoff.

API-first

Your app owns upload and results; Transmutify handles mapping, review, and delivery.

acme-employees.xlsx

Messy input customer spreadsheet
E-Mail AddressNAMEDept. / Team
Maya.Chen@ACME.test Chen, maya mgmt.
noah.patel@acme.testNoah PATEL Sales & Support (ext)

Clean records

approved output

Schema-ready
emailfull_namerole
maya.chen@acme.test Maya ChenManager
noah.patel@acme.test Noah PatelEmployee
POST /v1/transformations

Data handling and trust signals

CSV, TSV, XLSX, TXT, images

Accept the messy onboarding files customers already have.

PII-safe file mapping

Sample rows are masked before file mapping reaches an AI provider.

Hosted human approval

Final output waits for mapping, validation, and reviewer approval.

Verified webhooks

Final-stage lifecycle events include a shared secret header.

Bring your own storage

Keep transformation inputs and outputs in your own AWS S3 bucket.

7-day output retention

Produced JSON or CSV artifacts stay downloadable for a fixed window.

Headless API

Own the upload. Hand off the review.

Your product collects the file or raw input and creates the run from your backend. Transmutify returns upload instructions plus a hosted review_url for mapping, validation, and approval before final output returns to your API flow.

Your product owns the upload

Keep the customer-facing import flow in your app while your backend creates the run.

Reviewers get a purpose-built link

Send the review_url to the person who should check mapping, validation, and approval.

One API call starts an import

Create a run with a file and schema, then track it until clean records are ready.

Your AI agent integrates it in an afternoon

Use the Playground's AI Instructions to guide Claude Code or Cursor through the integration.

Your product — your UI

nothing embedded

start transformation

curl -X POST https://api.transmutify.io/v1/transformations/file \
  -H "Authorization: Bearer tmf_..." \
  --json '{
    "schema_id": "9f3c1e2a-8c41-4b6e-b1a7-3f2d8e90",
    "provider_id": "c4a8d6f0-52b9-47e3-9d18-6e01b7aa",
    "filename": "acme-employees.xlsx",
    "notify_url": "https://your-app.example/webhooks/transmutify"
  }'

201 Created

{
  "id": "7b1d2f64-9c3e-4f8a-b2d1-5a87c043",
  "status": "awaiting_upload",
  "review_url": "https://review.transmutify.io/reviews/...",
  "upload": { "method": "PUT", "url": "https://..." }
}
Explore the full API reference

Workflow

From client spreadsheet to clean onboarding data.

The core flow mirrors an implementation workflow: create a run, open the hosted review, approve the result, and hand clean records back to your product.

01

Receive onboarding data

Accept the employee, user, or account spreadsheet your customer already has — or a photo or scan of it.

02

Review the import mapping

AI can compare the customer's columns to your fixed schema, then the hosted review lets a human validate and approve the full transformation.

03

Provision clean records

Approve the review and provision normalized users, employees, and accounts straight into your product.

Hosted Review

Give reviewers a focused place to approve the import.

Every run creates a hosted review URL. Reviewers confirm the file mapping, fix validation issues, and approve the data before Transmutify writes final output or calls your webhook.

Review URL from every run

File and raw transformations return a hosted link before final output is produced.

AI-assisted mapping

For files, AI proposes the schema mapping; a reviewer stays in control of approval.

Brandable review UI

Customize the Review appearance with your brand name, logo, favicon, accent color, and support URL.

Speaks the reviewer's language

Set a locale per review to localize the hosted UI, and label schema columns in the terms your reviewers know.

Approval controls

Reviewers fix required fields, approve all rows, or approve only valid rows.

ACME onboarding review

Branded review_url ready

Cancel Approve review
Custom logo, accent color, favicon, and support link

Mapping

Source columns to schema fields

Validate Data

Edit rows and resolve errors

SourceField
E-Mail Addressemail
NAMEfull_name
Dept. / Teamrole
All
2
Valid
1
Error
1
1 saved edit
# Email * Full name * Role *
1
2

Playground

See the whole workflow before the first production call.

After signup, the playground walks you through it: pick a provider and target schema, upload sample data, generate the hosted review, and approve the review. When the review sends you back, the callback page gives you copyable cURL examples for the API calls that started the flow. Or skip the typing entirely: hand the playground's AI Instructions to Claude Code or Cursor and let your agent build the integration.

Terminal-first? Follow the 5-minute Quickstart instead.

Playground

Playground · cURL

Transform

Select a provider, target schema, and onboarding source data.

Playground cURL

Configure

Provider and schema

Input

File or raw data

Review

Hosted review

Result

Output download

Provider

Claude Sonnet

Target Schema

Employee import

Input

Upload a file or paste raw onboarding data.

File Raw

acme-employees.xlsx

CSV, TSV, TXT, Excel files or Images

File uploads generate an editable hosted review first. Playground transformations use the same API flow as external integrations.
Generate Review

Monitoring

Track every customer import from review to done.

Review, processing, completed, failed — every run is visible with full history. Webhooks hand finished imports back to your product the moment they're ready.

Onboarding runs

Review, processing, completed, and failed states with full history per customer import.

Product handoff

Webhooks notify your implementation flow the moment clean onboarding data is ready to import.

onboarding_acme_8f4c2b

Dashboard

Onboarding import performance

Last 7 days

7d 30d

Total runs

24

22 completed

Success rate

91%

Rows processed

48.2k

across all runs

Avg duration

42s

per run

FileStatus
acme-employees.xlsx
Completed
new-users.csv
Processing
department-mapping.tsv
Review

Developers

Built by developers, for developers.

We obsess over the debugging loop. Every webhook delivery is captured in full — copy the exact cURL and run it from your shell, or replay it from the dashboard until your handler is solid. Dry runs let you wire up the whole integration before a single real run.

Every delivery captured

Headers, payload, response code, and attempt count are recorded for every webhook send — the full delivery history per run.

Copy the cURL, run it anywhere

Reproduce any webhook exactly from your shell to exercise your endpoint locally while you build the handler.

Replay with one click

Re-fire a delivery straight from the dashboard while you debug — no new transformation run required.

Dry-run the whole lifecycle

Dry runs walk every run state with synthetic, schema-shaped output and zero AI provider calls, so you can wire up and debug the integration end-to-end first.

Read the webhook docs

transformation.finished

delivered
curl -X POST 'https://your-app.example/webhooks/transmutify' \
  -H 'Content-Type: application/json' \
  -H 'X-Transmutify-Event: transformation.finished' \
  -H 'X-Transmutify-Id: 7b1d2f64-9c3e-4f8a-b2d1-5a87c043' \
  -H 'X-Transmutify-Webhook-Secret: whsec_live_example' \
  --data '{
    "event": "transformation.finished",
    "id": "7b1d2f64-9c3e-4f8a-b2d1-5a87c043",
    "status": "completed",
    "stage": "final",
    "review_state": "approved",
    "download_url": "https://storage.example.com/…signed…"
  }'

3 attempts · 200 OK

FAQ

Frequently asked questions

Ready when your workspace is

Onboard your next client faster.

Sign up, configure a provider and schema, then validate the first customer import in the playground — and let your clients onboard themselves from there.

© 2026 Transmutify. All rights reserved.