OpenAPI / REST Integrations

OpenAPI Consumers

Salesforce AgentForce, Google Agent Directory, and other OpenAPI platforms.

SocialCRM publishes an auto-generated OpenAPI 3.1.0 spec at:

GET https://socialcrm.com/api/mcp-app/openapi.json

This spec is publicly accessible (no auth required to fetch it) and describes all 21 tools as individual REST endpoints. Any platform that consumes OpenAPI specs can import it directly.

Who This Is For

This guide covers platforms that ingest OpenAPI definitions to expose external tools to their agents. If your platform speaks MCP instead, see the Generic MCP Client guide.

Salesforce AgentForce

AgentForce supports external actions via OpenAPI specs. To connect:

  1. In Salesforce Setup, navigate to AgentForce > External Actions.
  2. Create a new action and select Import from URL.
  3. Enter the spec URL: https://socialcrm.com/api/mcp-app/openapi.json
  4. Configure authentication as Bearer Token with your SocialCRM API key (sk_live_...).
  5. Map the imported actions to your agent's capabilities.

Note: This integration path is in preview. If you encounter schema compatibility issues, contact support@socialcrm.com.

Google Agent Directory

Google's agent directory and Gemini extensions can consume OpenAPI specs for tool definitions. The setup flow is similar:

  1. Register your extension in the Google Cloud Console.
  2. Point the tool definition to the SocialCRM OpenAPI spec URL.
  3. Configure OAuth or API key auth per Google's requirements.

Note: Google's agent directory is evolving. Check Google's latest documentation for the current import process.

Other OpenAPI Consumers

Any platform that supports OpenAPI 3.1.0 can use the spec. The general pattern is:

  1. Fetch the spec: GET https://socialcrm.com/api/mcp-app/openapi.json
  2. Configure auth: Bearer token in the Authorization header.
  3. Call endpoints: Each tool has a dedicated POST endpoint at /api/mcp-app/rest/{tool_name}.

REST Endpoint Pattern

POST https://socialcrm.com/api/mcp-app/rest/list_brand_profiles
Authorization: Bearer sk_live_YOUR_KEY
Content-Type: application/json

{}

Tools that require arguments accept them in the JSON body:

POST https://socialcrm.com/api/mcp-app/rest/get_brand_profile
Authorization: Bearer sk_live_YOUR_KEY
Content-Type: application/json

{
  "brandId": "Ace Auto Repair"
}

Testing

Verify your integration works by calling the simplest tool first:

curl -X POST https://socialcrm.com/api/mcp-app/rest/get_credits \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

A successful response returns your credit balance and confirms auth is working.

Need Help?

If your platform isn't listed here but consumes OpenAPI, the integration pattern is the same. Reach out at support@socialcrm.com and we'll help you get connected.