API REFERENCE

Create a connection

Start a third-party connection and return the provider authorization link the user must complete.

Requires authentication — a Bearer token or X-Memuron-Actor-Id header.

Path parameters

providerstringrequired

Body parameters

space_refstringoptional

redirect_urlstringoptional

document_limitintegeroptional

Documents land in space_ref, defaulting to the organization's default space. The connection cannot sync until the user finishes choosing files.

POST/memuron/connectors/{provider}

curl -X POST https://api.memuron.com/memuron/connectors/{provider} \
  -H "Content-Type: application/json"

import requests, os

res = requests.post(
    "https://api.memuron.com/memuron/connectors/{provider}",
    headers={"Authorization": f"Bearer {os.environ['MEMURON_KEY']}}"},
    json={},
)
print(res.json())

const res = await fetch("https://api.memuron.com/memuron/connectors/{provider}", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
});
const data = await res.json();

200 OK

{
  "id": "…",
  "provider": "google-drive",
  "auth_link": "https://accounts.google.com/o/oauth2/v2/auth?…",
  "expires_in": "15 minutes",
  "redirects_to": "https://yourapp.com/connected"
}