Space access and integrations

Manage access to your Builder Space and connect it with external systems. Use these operations to retrieve users, configure SSO providers, and create webhooks for automated workflows.

Get users

Retrieve all users from a Builder Space.

Framework

To get all users from your Builder Space, use the following query.

Query

const response = await adminSDK .query({ users: { id: true, name: true, email: true, role: true, lastActive: true } });

Response

{ "data": { "users": [ { "id": "...", "name": "Elena Aguilar", "email": "elena@builder.io", "role": "admin", "lastActive": 1746049078845 }, ... ] } }

Configure SSO providers

To configure SSO providers through the Admin API, SSO must first be enabled for your space. For more details on SSO options, see SSO with your Identity Provider and Using Code Flow with SSO.

Framework

To set up a new SAML authentication provider within your space, use the following query.

const result = await adminSDK.chain.mutation.addSAMLProvider({ settings: { displayName: "Company SSO", idpEntityId: "https://sso.company.com/entityId", ssoURL: "https://sso.company.com/login", x509Cert: "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----", rpEntityId: "https://www.builder.io" } });

To set up an OIDC authentication provider within your space, use the following query.

const result = await adminSDK.chain.mutation.addOIDCProvider({ settings: { displayName: "Company SSO", clientId: "https://sso.company.com/entityId", issuer: "" } });

Create a webhook

Add one or more webhooks to existing Spaces.

Framework

const result = await adminSDK .chain.mutation.updateWebhooks({ webhooks: [ { url: "https://webhook1.example.com/content-update", disablePayload: false, customHeaders: [ { name: "Authorization", value: "Bearer token123" } ] }, { url: "https://webhook2.example.com/notify", disablePayload: true, customHeaders: [] } ] });

What's next

Continue to explore the Admin API documentation or use the GraphQL Explorer to try out these queries with your own Space and Organization. Then, visit the Admin API GraphQL Schema for more details on how to modify your queries.