Skip to main content

Agent Workflow

This guide explains the typical integration between a staging company (API user) and estate agents (end users).

The Flow

Integration steps

1. Stage photos as they come in

# When an agent uploads property photos to your platform
for photo in agent_uploaded_photos:
    result = stage_image(photo, style="modern")
    store_claim_code(
        agent_id=agent.id,
        claim_code=result["claim_code"],
        image_url=result["image_url"]
    )

2. Notify the agent

# Send the agent their claim codes
send_email(
    to=agent.email,
    subject="Your virtual staging is ready",
    body=f"""
    Your property has been virtually staged!

    Claim your images at studio.stagingspaces.app
    Claim code: {claim_code}

    This code expires in 30 days.
    """
)

3. Track redemptions via webhooks

# Webhook handler
if event_type == "claim.redeemed":
    agent_email = event["data"]["claimed_by_email"]
    mark_staging_delivered(agent_email)

Revenue model

  • You pay: 1 credit ($1) per staged image
  • Agent earns: 50% of product placement ad revenue
  • You earn: The difference between what you charge the agent and $1/image
Most staging companies charge 1030perimageanduseStagingSpacesat10-30 per image and use StagingSpaces at 1/image for 90%+ margins.