Invite Marketplace (Admin)

POST

/api/marketplace-dashboard/admin/invite

Admin Only - Create a new marketplace and send invitation.

What happens:

Creates marketplace record with OAuth credentials

Generates client_id and client_secret

Sends invitation email to technical contact

Returns credentials (store securely!)

IMPORTANT:

The client_secret is only shown ONCE in this response

Store it securely before sharing with marketplace

If lost, use the regenerate endpoint after registration

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Marketplace created and invitation sent

Body

🟠400

🟠401

🟠403

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dev.opensylo.com/api/marketplace-dashboard/admin/invite' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "platformName": "chowdeck",
    "displayName": "Chowdeck",
    "companyName": "Chowdeck Technologies Limited",
    "platformType": "FOOD_DELIVERY",
    "description": "Leading food delivery platform in Nigeria",
    "logo": "https://chowdeck.com/logo.png",
    "website": "https://chowdeck.com",
    "registeredAddress": "123 Victoria Island, Lagos, Nigeria",
    "operatingAddress": "456 Lekki Phase 1, Lagos, Nigeria",
    "cacNumber": "RC123456",
    "technicalContactName": "John Developer",
    "technicalContactEmail": "developer@chowdeck.com",
    "technicalContactPhone": "+2348012345678",
    "operationalContactName": "Jane Operations",
    "operationalContactEmail": "operations@chowdeck.com",
    "operationalContactPhone": "+2348098765432",
    "redirectUris": [
        "https://chowdeck.com/oauth/callback",
        "https://staging.chowdeck.com/oauth/callback"
    ],
    "webhookUrl": "https://api.chowdeck.com/webhooks/opensylo",
    "allowedScopes": [
        "data.share.sales",
        "data.share.fulfillment",
        "credit.score.read"
    ]
}'

Response Example

{
    "success": true,
    "message": "Marketplace invitation sent successfully",
    "marketplaceId": "mkt_abc123",
    "clientId": "chowdeck_client_abc123",
    "clientSecret": "cs_secret_xyz789...",
    "invitationSentTo": "developer@chowdeck.com"
}

Modified at 2025-12-30 08:04:15

Get Current User

OAuth Authorization Endpoint