Documentation

Everything you need to integrate Morphix into your data pipelines.

Getting Started

5 minute setup guide to your first transformation.

API Reference

Complete API documentation with examples.

Guides

Step-by-step tutorials for common use cases.

Welcome to Morphix

Morphix is the AI-powered transformation layer for modern data stacks. Use Morphix to ingest files, normalize schemas, and deliver clean, validated outputs to your warehouse, CRM, or downstream apps.

App Console: https://morphix.app
API Base URL: https://api.morphix.app/v1

Quick Start

Provision an API key, upload a file, and get a normalized output in minutes.

  1. Sign in to the Morphix console and create a new workspace.
  2. Generate an API key under Settings → API Keys.
  3. Upload a sample file to inspect detected columns and types.

First Transform

Transform your first file using cURL:

curl -X POST https://api.morphix.app/v1/transform \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@data.xlsx" \
  -F "target_schema=customer_v1"

The response includes a job_id and a download_url. Poll the job endpoint or register a webhook to receive completion events.

API Keys

API keys are workspace-scoped and support role-based permissions. Rotate keys quarterly and restrict them to the minimum scopes needed for each integration.

  • Production keys are labeled and require 2FA to create.
  • Use environment variables to inject keys into CI/CD pipelines.
  • Keys can be revoked instantly without downtime for existing jobs.

Schemas & Mapping

Define a target schema to normalize fields across source systems. Morphix learns from examples and suggests mappings that you can approve or override.

  • Schema definitions support nested objects, arrays, and custom enum types.
  • Map multiple input columns into a single output field with templates.
  • Store mapping profiles per integration to reuse across datasets.

Validation Rules

Validation rules ensure output quality. Define required fields, data type constraints, and cross-field dependencies before export.

  • Flag invalid records with structured error reasons.
  • Apply normalization rules like phone or address formatting.
  • Route invalid rows to a quarantine dataset for review.

Transform Plans

Transform plans bundle schemas, mappings, and validation into reusable workflows. Plans can be scheduled or triggered via API.

  • Create versioned plans to support schema migrations.
  • Attach enrichment steps like geocoding or deduplication.
  • Enable incremental processing for large uploads.

Connectors

Connectors sync data to your favorite tools. Use native integrations or webhook exports to deliver transformed data to destinations.

  • Data warehouses: Snowflake, BigQuery, Redshift.
  • CRMs: Salesforce, HubSpot, and custom APIs.
  • Storage: S3, Google Cloud Storage, Azure Blob.

Authentication

All API requests use bearer authentication. Send the API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Endpoints

Common endpoints for upload, status checks, and exports.

EndpointMethodDescription
/transformPOSTSubmit a new transformation job.
/jobs/:idGETCheck job status and metadata.
/jobs/:id/outputGETDownload the transformed output.
/webhooksPOSTCreate a webhook subscription.

Errors

Errors use standard HTTP codes with structured JSON payloads. Capture the request_id for support.

{ "error": { "code": "invalid_schema", "message": "Target schema customer_v1 is missing required field email", "request_id": "req_9fd2f" } }

Webhooks

Register webhooks to receive job status changes. Webhooks retry on failure and include a signature for verification.

  • Events: job.created, job.completed, job.failed.
  • Verify signatures with your webhook secret.
  • Use idempotent handlers to prevent duplicate processing.

SDKs

Use SDKs for faster integration and typed responses.

  • TypeScript: @morphix/sdk
  • Python: morphix-sdk
  • Go: github.com/morphix/app-sdk

Migration Guide

Migrating from legacy ETL? Start by documenting your current schema, then map fields to Morphix targets and validate outputs in a staging workspace.

  • Export mapping templates from the Morphix console.
  • Run side-by-side comparisons on historical data.
  • Promote the plan to production once validation is clean.

Release Notes

Track new features, deprecations, and API changes in the release feed inside the Morphix console. Subscribe to updates for weekly summary emails.

Support

Need help? Reach our support team via the in-app messenger or email support@morphix.app.

  • Enterprise SLA: 24/5 coverage with a 1-hour response time.
  • Community: Join the public roadmap and feature requests.
  • Status: Monitor incidents at status.morphix.app.

Next Steps