Create integration
zero_trust.casb.integrations.create(IntegrationCreateParams**kwargs) -> IntegrationCreateResponse
POST/accounts/{account_id}/one/integrations
Creates a new integration for the specified application. Integration creation with OAuth is not supported by API at the moment. For other auth methods, use GET /v2/applications/{application_id}/credential-guide to see the required credential structure and example payloads for each vendor.
Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
Example:
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
Example:
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
Example:
Parameters
Create integration
import os
from cloudflare import Cloudflare
client = Cloudflare(
api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted
)
integration = client.zero_trust.casb.integrations.create(
account_id="023e105f4ecef8ad9ca31a8372d0c353",
application="GOOGLE_WORKSPACE",
credentials={
"admin_email": "admin@corp.com"
},
name="My Google Workspace",
auth_method="service_account",
dlp_profiles=["e91a2360-da51-4fdf-9711-bcdecd462614"],
permissions=["https://www.googleapis.com/auth/drive.readonly"],
use_cases=["casb", "ces"],
)
print(integration.id){
"errors": [],
"messages": [],
"result": {
"application": {
"category": "Productivity",
"display_name": "Google Workspace",
"logo": "https://dash.cloudflare.com/v2/static/google_workspace.png"
},
"auth_method": {
"display_name": "OAuth 2.0",
"id": "oauth"
},
"authorization_link": {
"components": {
"client_id": "abc",
"instance_name": "example"
},
"link": "https://example.cloudflare.com/authorize"
},
"created": "2025-01-01T00:00:00Z",
"credentials_expiry": "2026-01-01T00:00:00Z",
"dlp_profiles": [
"e91a2360-da51-4fdf-9711-bcdecd462614"
],
"health_details": [],
"id": "019d2e6a-d995-7185-afbd-4feead9e42ec",
"is_paused": false,
"last_hydrated": "2025-04-10T08:30:00Z",
"name": "My Google Workspace",
"status": "Healthy",
"updated": "2025-04-10T08:30:00Z",
"use_cases": [
{
"description": "Discover and secure SaaS applications",
"features": [
{
"description": "Automatically remediate security issues (requires write permissions)",
"id": "auto_remediation",
"is_enabled": true,
"name": "Auto Remediation",
"permissions": [
{
"display_name": "Manage users",
"scope": "https://www.googleapis.com/auth/admin.directory.user",
"status": "granted"
}
]
}
],
"id": "casb",
"is_enabled": true,
"name": "Cloud Access Security Broker",
"permissions": [
{
"display_name": "Drive (Read Only)",
"scope": "https://www.googleapis.com/auth/drive.readonly",
"status": "granted"
},
{
"display_name": "Gmail (Read Only)",
"scope": "https://www.googleapis.com/auth/gmail.readonly",
"status": "missing"
}
]
},
{
"description": "Protect against email-based threats",
"features": [],
"id": "ces",
"is_enabled": false,
"name": "Cloud Email Security",
"permissions": []
}
]
},
"success": true
}Returns Examples
{
"errors": [],
"messages": [],
"result": {
"application": {
"category": "Productivity",
"display_name": "Google Workspace",
"logo": "https://dash.cloudflare.com/v2/static/google_workspace.png"
},
"auth_method": {
"display_name": "OAuth 2.0",
"id": "oauth"
},
"authorization_link": {
"components": {
"client_id": "abc",
"instance_name": "example"
},
"link": "https://example.cloudflare.com/authorize"
},
"created": "2025-01-01T00:00:00Z",
"credentials_expiry": "2026-01-01T00:00:00Z",
"dlp_profiles": [
"e91a2360-da51-4fdf-9711-bcdecd462614"
],
"health_details": [],
"id": "019d2e6a-d995-7185-afbd-4feead9e42ec",
"is_paused": false,
"last_hydrated": "2025-04-10T08:30:00Z",
"name": "My Google Workspace",
"status": "Healthy",
"updated": "2025-04-10T08:30:00Z",
"use_cases": [
{
"description": "Discover and secure SaaS applications",
"features": [
{
"description": "Automatically remediate security issues (requires write permissions)",
"id": "auto_remediation",
"is_enabled": true,
"name": "Auto Remediation",
"permissions": [
{
"display_name": "Manage users",
"scope": "https://www.googleapis.com/auth/admin.directory.user",
"status": "granted"
}
]
}
],
"id": "casb",
"is_enabled": true,
"name": "Cloud Access Security Broker",
"permissions": [
{
"display_name": "Drive (Read Only)",
"scope": "https://www.googleapis.com/auth/drive.readonly",
"status": "granted"
},
{
"display_name": "Gmail (Read Only)",
"scope": "https://www.googleapis.com/auth/gmail.readonly",
"status": "missing"
}
]
},
{
"description": "Protect against email-based threats",
"features": [],
"id": "ces",
"is_enabled": false,
"name": "Cloud Email Security",
"permissions": []
}
]
},
"success": true
}