How to migrate from SuperOkay to AgencyPro

SuperOkay lets you download documents as PDFs, but has no bulk data export or public API. Moving to AgencyPro means building your client CSV, importing clients and services, and recreating active work. This guide covers each step.

Why agencies switch from SuperOkay

Native requests and billing

Requests, approvals, invoices and payments are built in, so fewer embedded third-party tools are needed.

Services clients can order

A service catalog and order forms let clients buy fixed-price or subscription services.

Delivery tools on Pro

Time tracking, design annotation and versioned proofing sit on each request.

Embeds still possible

Tools you rely on can be added to the portal menu with extensions on Pro and Plus.

Example migration timeline

Week 1: Export and import

  • Days 1-2: Export from SuperOkay and choose a cutover date
  • Days 3-4: Import clients and services by CSV
  • Days 5-7: Connect Stripe or PayPal and set up subscriptions

Week 2: Rebuild and cut over

  • Days 8-10: Recreate active work as requests
  • Days 11-12: Invite your team and clients
  • Days 13-14: Parallel run, final export, cancel SuperOkay

Step-by-step migration process

  1. 1

    Export your data from SuperOkay

    In SuperOkay, open each document you need to keep, go to Share and choose Download as PDF. Write down each client and their contacts for the client CSV.

  2. 2

    Prepare your client CSV

    In AgencyPro, open Imports > Clients and download the template. Every row needs a contact name, an email and an organization (company) name; the import runbook below shows which SuperOkay field goes in which column. Keep each file under 1,000 rows and test with a few rows first.

  3. 3

    Import clients

    Upload the CSV under Imports > Clients, map any columns the importer did not match automatically, and check the preview. Import stays disabled until the preview shows no errors. Rows whose email is already in AgencyPro are skipped, so a corrected file can be re-run safely.

  4. 4

    Import services

    Download the template from Imports > Services and add the services you sell. Each row needs a name, a type (one_time or recurring) and a pricing type (standard, time_based or credit_based); prices go in as plain numbers. Upload, check the preview and confirm. Credit-based and hourly services need the Pro plan, and recurring services get their billing period in the service editor after import.

  5. 5

    Connect payments and subscriptions

    Connect Stripe under Payments > Stripe Connect or add PayPal, then recreate retainers as service subscriptions. Clients enter payment details again, because saved cards do not move between platforms.

  6. 6

    Recreate active work

    Recreate each client's open work as AgencyPro requests, and re-add embedded tools you still need as portal extensions (Pro and Plus).

  7. 7

    Invite your team and clients

    Invite team members (each seat after the first is billed per plan), then send clients their portal invitation with a short note on where to submit requests and find invoices.

  8. 8

    Run in parallel, then cancel SuperOkay

    Run both tools for one billing cycle. When new requests and payments are running in AgencyPro, save a final SuperOkay export and cancel.

What moves to AgencyPro, and how

-Client list: built by hand, then CSV import (Imports > Clients)
-Services: CSV import (Imports > Services)
-Documents: downloaded as PDFs and uploaded where needed
-Active work: recreated as requests by hand, or with the Plus migration team
-Embedded tools: re-added as portal extensions (Pro and Plus)
-Comments: kept in the PDFs, not imported
-Portal layouts: rebuilt with AgencyPro navigation and branding
-Team members: invited to AgencyPro (seats billed per plan)

Import runbook: SuperOkay to AgencyPro

AgencyPro's CSV importer takes two files: clients (Imports > Clients) and services (Imports > Services). Each has a downloadable template, and each file can hold up to 1,000 rows. Projects, tasks, files, messages, invoices, payment history, saved cards and time entries are not imported; they are set up by hand or with the migration service on the Plus plan. Where a vendor does not publish its export headers, the left column describes the data, and you match the real header in the importer's mapping step.

1. Client file

Where it comes from: SuperOkay has no documented bulk client export. Write the client list by hand from your documents and invoices. SuperOkay help center

From SuperOkayAgencyPro columnNotes
Client companyorganization_nameRequired.
Contact name (from your CRM, invoices or billing tool)nameRequired. The person who will log in to the portal.
Contact emailemailRequired. One row per email; an email already in AgencyPro is skipped.

Rows with the same organization_name become contacts of one organization, and the first of them becomes its owner. The match is exact, so "Example Co" and "Example Co." create two organizations. Address and billing details are taken from the first row of each organization. Columns you do not map are ignored.

2. Service file

Where it comes from: Copy the services and prices from your SuperOkay proposals into the template.

From your offerAgencyPro columnNotes
Service or package namenameRequired. Must be unique; a name already in AgencyPro is skipped.
Short descriptiondescription
One-off or ongoingtypeRequired: one_time or recurring.
How it is pricedpricing_typeRequired: standard, time_based or credit_based. Time-based and credit-based services need Pro.
PricepriceA plain number such as 2500.00. A currency sign or thousands comma leaves the price empty.
Hours in a time blockhoursFor time_based services.
Credits per purchasecreditsFor credit_based services.
Shown to clients in the catalogshow_in_catalogtrue or false. Defaults to true.

The CSV sets the basics only. After import, open each recurring service and add its pricing tier (billing period and price per period), and set intake form fields, images, turnaround and FAQs in the service editor.

3. Sample files

Example data, in the column names AgencyPro's templates use. Download the real templates from Imports > Clients and Imports > Services; they include every optional column.

clients.csv

name,email,phone,position,organization_name,billing_city,billing_country
"Jane Example","jane@example.com","+1 555 0100","Marketing Lead","Example Co","Austin","US"
"Sam Example","sam@example.com","","Founder","Example Co","Austin","US"
"Lee Sample","lee@sample.org","","Owner","Sample Studio","Leeds","GB"

services.csv

name,description,type,pricing_type,price,hours,credits,show_in_catalog
"Website audit","Technical and content audit","one_time","standard","1500.00","","","true"
"SEO retainer","Monthly SEO work","recurring","standard","2000.00","","","true"
"Development hours (10)","Prepaid block of 10 hours","one_time","time_based","1200.00","10","","true"

4. Permissions

  • SuperOkay: Download each document you need as a PDF from its Share window before you cancel.
  • AgencyPro: importing clients needs the create clients permission, and importing services needs the create services permission, in your workspace role.
  • Importing does not email anyone. Clients get portal access when you send their invite from the client record, so you choose when they see the portal.

5. Validate

  • Import a test file of three to five rows first, then check those clients and services in AgencyPro.
  • In the mapping step, check every column. Headers such as Email, Company and Phone are matched automatically; map the rest by hand.
  • The preview checks the first 100 rows for missing required values, invalid emails and invalid type values, and the import stays disabled until it shows no errors. Later rows with errors are skipped and listed by row number in the results.
  • Rows whose email (clients) or name (services) already exists in the workspace are skipped, not overwritten.
  • Each imported client fires the Client Created event. If you run Zaps on that trigger (Zapier is on the Plus plan), pause them during the import.
  • After the import, export clients and services from Exports and compare the row counts with your SuperOkay file.

6. Roll back

  • There is no undo button. Select the imported clients or services in their lists and delete them in bulk, fix the CSV, and import again.
  • To correct a client that imported with wrong details, delete or edit it first: re-importing the same email skips the row.
  • Keep SuperOkay running until the parallel run ends. Your SuperOkay data is the fallback if anything needs re-checking.

Common migration challenges

Challenge: No bulk export

There is no client or document bulk export. Fix: list clients from your billing records and download each document you need.

Challenge: Embed-heavy portals

Portals built from many embeds need mapping. Fix: replace embeds with native AgencyPro features where possible and re-add the rest as extensions.

Challenge: Client familiarity

Clients know the old layout. Fix: send a short note showing where requests, files and invoices are.

Post-migration checklist

  • Client CSV imported and spot-checked against your SuperOkay export
  • Services imported with the right prices and types
  • Every active client has their open work recreated in AgencyPro
  • Stripe or PayPal connected and a test payment completed
  • Retainers rebuilt as subscriptions with the first payment confirmed
  • Team members invited with the right roles
  • Every SuperOkay document you need downloaded as a PDF
  • Final SuperOkay export saved before you cancel

Frequently asked questions

What can I import from SuperOkay into AgencyPro?

Clients and services, by CSV. AgencyPro's importer (Imports > Clients and Imports > Services) gives you a template, validates the file and shows a preview before you confirm, up to 1,000 rows per file. Projects, tasks, files, comments and history are not imported automatically. Recreate each client's open work as AgencyPro requests, and re-add embedded tools you still need as portal extensions (Pro and Plus).

Can I export my data from SuperOkay?

SuperOkay documents download as PDFs from the Share window. SuperOkay has said it is considering a public REST API but has no date for it, and we did not find a bulk client export, so the client list is built by hand.

How long does the move take?

It depends on how much active work you have. The client and service imports are quick once your CSVs match AgencyPro's templates. Rebuilding open work is the bigger job, so count your active clients and open items in SuperOkay before you pick a cutover date, and plan one billing cycle of parallel running. The timeline on this page is an example for a small agency.

What does the AgencyPro migration service include?

The migration service is part of the Plus plan ($149 a month, or $124.17 a month billed annually). The AgencyPro migration team helps you move from SuperOkay, including setting up the projects, tasks, files and history that the CSV importer does not bring in. On Basic and Pro you use the CSV importer and rebuild active work yourself.

When is it better to stay on SuperOkay?

If your portal is mainly a shared document hub and you do not invoice or take requests through it, SuperOkay may be enough. AgencyPro fits when requests and billing run through the portal.

Continue learning

Moving from SuperOkay?

Book a call and we will help you rebuild your client list and map your embeds to AgencyPro features or extensions.