Schedule LinkedIn Action

curl --request POST \
  --url https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "actionType": "<string>",
  "profileUrl": "<string>",
  "message": "<string>",
  "participantName": "<string>",
  "threadId": "<string>",
  "voiceSettings": {
    "voiceId": "<string>",
    "voiceText": "<string>",
    "voiceParams": {
      "stability": 123,
      "clarity": 123,
      "use_speaker_boost": true
    }
  }
}
'

import requests

url = "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction"

payload = {
    "actionType": "<string>",
    "profileUrl": "<string>",
    "message": "<string>",
    "participantName": "<string>",
    "threadId": "<string>",
    "voiceSettings": {
        "voiceId": "<string>",
        "voiceText": "<string>",
        "voiceParams": {
            "stability": 123,
            "clarity": 123,
            "use_speaker_boost": True
        }
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    actionType: '<string>',
    profileUrl: '<string>',
    message: '<string>',
    participantName: '<string>',
    threadId: '<string>',
    voiceSettings: {
      voiceId: '<string>',
      voiceText: '<string>',
      voiceParams: {stability: 123, clarity: 123, use_speaker_boost: true}
    }
  })
};

fetch('https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'actionType' => '<string>',
    'profileUrl' => '<string>',
    'message' => '<string>',
    'participantName' => '<string>',
    'threadId' => '<string>',
    'voiceSettings' => [
        'voiceId' => '<string>',
        'voiceText' => '<string>',
        'voiceParams' => [
                'stability' => 123,
                'clarity' => 123,
                'use_speaker_boost' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction"

	payload := strings.NewReader("{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "sendConnectionRequest action scheduled successfully with delay of 75000 ms."
}

POST

api

scheduleLinkedInAction

Schedule LinkedIn Action

curl --request POST \
  --url https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "actionType": "<string>",
  "profileUrl": "<string>",
  "message": "<string>",
  "participantName": "<string>",
  "threadId": "<string>",
  "voiceSettings": {
    "voiceId": "<string>",
    "voiceText": "<string>",
    "voiceParams": {
      "stability": 123,
      "clarity": 123,
      "use_speaker_boost": true
    }
  }
}
'

import requests

url = "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction"

payload = {
    "actionType": "<string>",
    "profileUrl": "<string>",
    "message": "<string>",
    "participantName": "<string>",
    "threadId": "<string>",
    "voiceSettings": {
        "voiceId": "<string>",
        "voiceText": "<string>",
        "voiceParams": {
            "stability": 123,
            "clarity": 123,
            "use_speaker_boost": True
        }
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    actionType: '<string>',
    profileUrl: '<string>',
    message: '<string>',
    participantName: '<string>',
    threadId: '<string>',
    voiceSettings: {
      voiceId: '<string>',
      voiceText: '<string>',
      voiceParams: {stability: 123, clarity: 123, use_speaker_boost: true}
    }
  })
};

fetch('https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'actionType' => '<string>',
    'profileUrl' => '<string>',
    'message' => '<string>',
    'participantName' => '<string>',
    'threadId' => '<string>',
    'voiceSettings' => [
        'voiceId' => '<string>',
        'voiceText' => '<string>',
        'voiceParams' => [
                'stability' => 123,
                'clarity' => 123,
                'use_speaker_boost' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction"

	payload := strings.NewReader("{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"actionType\": \"<string>\",\n  \"profileUrl\": \"<string>\",\n  \"message\": \"<string>\",\n  \"participantName\": \"<string>\",\n  \"threadId\": \"<string>\",\n  \"voiceSettings\": {\n    \"voiceId\": \"<string>\",\n    \"voiceText\": \"<string>\",\n    \"voiceParams\": {\n      \"stability\": 123,\n      \"clarity\": 123,\n      \"use_speaker_boost\": true\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "sendConnectionRequest action scheduled successfully with delay of 75000 ms."
}

Schedule LinkedIn Action

Schedule various LinkedIn actions including connection requests, messages, and data retrieval operations. The system automatically handles timing delays and rate limiting to ensure safe automation.

Requires the linkedin:schedule permission and an active LinkedIn integration in your account.

Request

x-api-key

string

required

Your API key with linkedin:schedule permission

Content-Type

string

required

Must be application/json

Body Parameters

actionType

string

required

Type of LinkedIn action to perform. See action types for available options.

profileUrl

string

LinkedIn profile URL. Required for actions targeting specific profiles. Format: https://linkedin.com/in/username

message

string

Message content for connection requests or direct messages. Required for messaging actions.

participantName

string

Name of conversation participant. Required for conversation-specific actions.

threadId

string

LinkedIn thread identifier. Required for thread-specific actions.

voiceSettings

object

Voice message configuration. Required for sendVoiceMessage action type.

Show Voice Settings

voiceId

string

required

ID of the voice clone to use for generating voice message

voiceText

string

required

Text to convert to voice message (1-500 characters)

voiceParams

object

Optional voice generation parameters

Show Voice Parameters

stability

number

default:"0.5"

Voice stability (0.0-1.0)

clarity

number

default:"0.75"

Voice clarity and similarity boost (0.0-1.0)

use_speaker_boost

boolean

default:"true"

Enhance speaker similarity

LinkedIn integration settings (timezone, account details) are automatically detected from your connected LinkedIn account. No additional configuration required.

Action Types

Connection Actions

sendConnectionRequest - Send a connection request - Requires: profileUrl - Optional: message (connection note) getAcceptedConnections - Retrieve accepted connections - No additional parameters required

Messaging Actions

sendMessageToFirst - Send first message to a connection - Requires: profileUrl, message sendFirstMessage - Send initial message - Requires: profileUrl, message sendVoiceMessage - Send message with voice attachment - Requires: profileUrl, message, voiceSettings

Data Retrieval

getLinkedInMessages - Get LinkedIn messages - No additional parameters required getSpecificConversationMessages - Get specific conversation - Requires: participantName accessConversationByThreadId - Access conversation by thread - Requires: threadId

Examples

Send Connection Request

curl -X POST "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionType": "sendConnectionRequest",
    "profileUrl": "https://linkedin.com/in/johndoe",
    "message": "Hi John, I'd love to connect and discuss potential collaboration opportunities!"
  }'

const response = await fetch(
  "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      actionType: "sendConnectionRequest",
      profileUrl: "https://linkedin.com/in/johndoe",
      message:
        "Hi John, I'd love to connect and discuss potential collaboration opportunities!",
    }),
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction',
    headers={
        'x-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'actionType': 'sendConnectionRequest',
        'profileUrl': 'https://linkedin.com/in/johndoe',
        'message': "Hi John, I'd love to connect and discuss potential collaboration opportunities!"
    }
)

print(response.json())

Send First Message

curl -X POST "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionType": "sendFirstMessage",
    "profileUrl": "https://linkedin.com/in/janedoe",
    "message": "Hi Jane, thank you for connecting! I noticed your expertise in AI and would love to discuss potential synergies."
  }'

const response = await fetch(
  "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      actionType: "sendFirstMessage",
      profileUrl: "https://linkedin.com/in/janedoe",
      message:
        "Hi Jane, thank you for connecting! I noticed your expertise in AI and would love to discuss potential synergies.",
    }),
  }
);

const data = await response.json();
console.log(data);

Send Voice Message

curl -X POST "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionType": "sendVoiceMessage",
    "profileUrl": "https://linkedin.com/in/johndoe",
    "message": "Hi John! I wanted to reach out personally about an exciting opportunity.",
    "voiceSettings": {
      "voiceId": "voice_abc123",
      "voiceText": "Hi John! I hope you're having a great week. I came across your profile and was really impressed by your experience in AI. I wanted to reach out personally about an exciting opportunity that I think could be a perfect fit for your background. Would love to chat more about it!",
      "voiceParams": {
        "stability": 0.6,
        "clarity": 0.8,
        "use_speaker_boost": true
      }
    }
  }'

const response = await fetch(
  "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      actionType: "sendVoiceMessage",
      profileUrl: "https://linkedin.com/in/johndoe",
      message:
        "Hi John! I wanted to reach out personally about an exciting opportunity.",
      voiceSettings: {
        voiceId: "voice_abc123",
        voiceText:
          "Hi John! I hope you're having a great week. I came across your profile and was really impressed by your experience in AI. I wanted to reach out personally about an exciting opportunity that I think could be a perfect fit for your background. Would love to chat more about it!",
        voiceParams: {
          stability: 0.6,
          clarity: 0.8,
          use_speaker_boost: true,
        },
      },
    }),
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction',
    headers={
        'x-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'actionType': 'sendVoiceMessage',
        'profileUrl': 'https://linkedin.com/in/johndoe',
        'message': 'Hi John! I wanted to reach out personally about an exciting opportunity.',
        'voiceSettings': {
            'voiceId': 'voice_abc123',
            'voiceText': 'Hi John! I hope you\'re having a great week. I came across your profile and was really impressed by your experience in AI. I wanted to reach out personally about an exciting opportunity that I think could be a perfect fit for your background. Would love to chat more about it!',
            'voiceParams': {
                'stability': 0.6,
                'clarity': 0.8,
                'use_speaker_boost': True
            }
        }
    }
)

print(response.json())

Get Accepted Connections

curl -X POST "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionType": "getAcceptedConnections"
  }'

const response = await fetch(
  "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      actionType: "getAcceptedConnections",
    }),
  }
);

const data = await response.json();
console.log(data);

Response

success

boolean

Always true for successful requests

message

string

Confirmation message indicating the action was scheduled successfully, including delay information

{
  "success": true,
  "message": "sendConnectionRequest action scheduled successfully with delay of 75000 ms."
}

Smart Scheduling

The system automatically applies intelligent delays to ensure safe automation:

Delay Calculation

Delays are calculated based on: - Your current activity level - LinkedIn’s rate limits - Time of day and timezone (from your LinkedIn account) - Account safety guidelines - Previous action history

Timezone Considerations

Actions are scheduled considering: - Business hours in your LinkedIn account timezone - Weekend vs weekday patterns - Regional LinkedIn usage patterns - Your account’s historical activity

Safety Features

Built-in safety mechanisms: - Automatic rate limiting - Human-like timing patterns - Activity distribution across time - Compliance with LinkedIn terms

Advanced Use Cases

1. Automated Outreach Campaign

async function runOutreachCampaign(prospects) {
  for (const prospect of prospects) {
    try {
      const response = await fetch(
        "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
        {
          method: "POST",
          headers: {
            "x-api-key": process.env.BUENA_API_KEY,
            "Content-Type": "application/json",
          },
          body: JSON.stringify({
            actionType: "sendConnectionRequest",
            profileUrl: prospect.linkedinUrl,
            message: personalizeMessage(prospect),
          }),
        }
      );

      const result = await response.json();

      if (result.success) {
        console.log(`✅ Scheduled connection request for ${prospect.name}`);
        await logActivity(prospect.id, "connection_scheduled");
      } else {
        console.error(
          `❌ Failed to schedule for ${prospect.name}:`,
          result.message
        );
      }

      // Small delay between scheduling requests
      await new Promise((resolve) => setTimeout(resolve, 1000));
    } catch (error) {
      console.error(`Error scheduling for ${prospect.name}:`, error);
    }
  }
}

function personalizeMessage(prospect) {
  return `Hi ${prospect.firstName}, I noticed your work at ${prospect.company} and would love to connect to discuss ${prospect.industry} trends!`;
}

2. Follow-up Message Sequence

import asyncio
import requests
from datetime import datetime, timedelta

class LinkedInSequence:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = 'https://api.buena.ai/api/v2'

    async def schedule_followup_sequence(self, profile_url, sequence_config):
        """Schedule a series of follow-up messages"""

        for step in sequence_config['steps']:
            response = requests.post(
                f'{self.base_url}/linkedin/scheduleLinkedInAction',
                headers={
                    'x-api-key': self.api_key,
                    'Content-Type': 'application/json'
                },
                json={
                    'actionType': step['action_type'],
                    'profileUrl': profile_url,
                    'message': step['message']
                }
            )

            if response.status_code == 200:
                result = response.json()
                print(f"✅ Scheduled {step['action_type']}")
            else:
                print(f"❌ Failed to schedule {step['action_type']}: {response.text}")

            # Wait between scheduling requests
            await asyncio.sleep(2)

# Example usage
sequence = LinkedInSequence('your-api-key')

campaign_config = {
    'steps': [
        {
            'action_type': 'sendConnectionRequest',
            'message': 'Hi! I'd love to connect.'
        },
        {
            'action_type': 'sendFirstMessage',
            'message': 'Thanks for connecting! How's your week going?'
        }
    ]
}

await sequence.schedule_followup_sequence(
    'https://linkedin.com/in/prospect',
    campaign_config
)

3. Connection Acceptance Monitoring

async function monitorConnections() {
  const response = await fetch(
    "https://api.buena.ai/api/v2/linkedin/scheduleLinkedInAction",
    {
      method: "POST",
      headers: {
        "x-api-key": process.env.BUENA_API_KEY,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        actionType: "getAcceptedConnections",
      }),
    }
  );

  const result = await response.json();

  if (result.success) {
    console.log("✅ Connection monitoring scheduled");

    // Schedule follow-up messages for new connections
    // This would typically be handled by a webhook or polling system
  }

  return result;
}

// Run daily to check for new connections
setInterval(monitorConnections, 24 * 60 * 60 * 1000);

Error Responses

Permission Denied (403)

{
  "error": true,
  "code": "PERMISSION_DENIED",
  "message": "Insufficient permissions for LinkedIn scheduling",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "permissionHelp": {
    "required": "linkedin:schedule",
    "available": ["linkedin:read"],
    "documentation": "https://docs.buena.ai/authentication"
  }
}

LinkedIn Not Connected (400)

{
  "error": true,
  "code": "LINKEDIN_NOT_CONNECTED",
  "message": "LinkedIn account not connected",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "details": {
    "action": "Connect your LinkedIn account in the dashboard",
    "dashboardUrl": "https://app.buena.ai/integrations/linkedin"
  }
}

Invalid Profile URL (400)

{
  "error": true,
  "code": "INVALID_LINKEDIN_URL",
  "message": "Invalid LinkedIn profile URL format",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "details": {
    "providedUrl": "https://example.com/profile",
    "expectedFormat": "https://linkedin.com/in/username"
  }
}

Rate Limited (429)

{
  "error": true,
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "LinkedIn action rate limit exceeded",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "retryAfter": 300,
  "details": {
    "dailyLimit": 100,
    "used": 100,
    "resetTime": "2024-01-21T00:00:00Z"
  }
}

Best Practices

Message Personalization

Personalize messages for better engagement:

function createPersonalizedMessage(prospect) {
  const templates = [
    `Hi ${prospect.firstName}, I noticed your work at ${prospect.company} and would love to connect!`,
    `Hello ${prospect.firstName}, your background in ${prospect.industry} caught my attention. Let's connect!`,
    `Hi ${prospect.firstName}, I'd love to learn more about your role at ${prospect.company}.`
  ];
  
  return templates[Math.floor(Math.random() * templates.length)];
}

Error Handling

Implement robust error handling:

async function scheduleWithRetry(actionData, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await scheduleLinkedInAction(actionData);
      return response;
    } catch (error) {
      if (error.code === 'RATE_LIMIT_EXCEEDED' && attempt < maxRetries) {
        const delay = error.retryAfter * 1000;
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }
      throw error;
    }
  }
}

Next Steps

Upload Prospects

Upload bulk prospect lists for automation

Check User Status

Verify LinkedIn integration status

Monitor Jobs

Track LinkedIn action job status

LinkedIn Guide

Learn advanced LinkedIn automation

Get API Key Statistics Upload Prospects

​Schedule LinkedIn Action

​Request

​Body Parameters

​Action Types

​Examples

​Send Connection Request

​Send First Message

​Send Voice Message

​Get Accepted Connections

​Response

​Smart Scheduling

​Advanced Use Cases

​1. Automated Outreach Campaign

​2. Follow-up Message Sequence

​3. Connection Acceptance Monitoring

​Error Responses

​Permission Denied (403)

​LinkedIn Not Connected (400)

​Invalid Profile URL (400)

​Rate Limited (429)

​Best Practices

​Next Steps

Upload Prospects

Check User Status

Monitor Jobs

LinkedIn Guide

Schedule LinkedIn Action

Request

Body Parameters

Action Types

Examples

Send Connection Request

Send First Message

Send Voice Message

Get Accepted Connections

Response

Smart Scheduling

Advanced Use Cases

1. Automated Outreach Campaign

2. Follow-up Message Sequence

3. Connection Acceptance Monitoring

Error Responses

Permission Denied (403)

LinkedIn Not Connected (400)

Invalid Profile URL (400)

Rate Limited (429)

Best Practices

Next Steps