Developer Portal
Generate Messages API
This API enables you to load your prospects and request LinkedIn messages to be generated.
Endpoint URL
Authentication
To ensure the security of data transmission, our API requires API key-based authentication. Include your Koneksi-Start-Messages-Api-Key in the request header for each call. You can find your API key on your Manage Account page within the Koneksi Admin account.
Content Headers
This endpoint allows you to create a new user (or update an existing user) and associate prospects with that user. The system will process your data and generate customized messages for each prospect.
Request Body
Example request body:
Description of each User element in the request body. This includes information about the product being taken to market in this campaign.
| Element | Field type | Description |
|---|---|---|
| full_name | string | Full name of the user. |
| string | Email address of the user (used as the unique ID for that user). | |
| company_name | string | Company name for the product being sold/taken to market. |
| customer_company_website | string | Company website URL for the product being sold/taken to market. |
| short_company_description | text | Two line description of product being taken to market. |
| benefits_of_product | text | Benefits of the product that will be realised by prospects should they use it. |
| ideal_customer_profile | text | Detailed description of typical target prospect and their relevant needs |
| list_of_pains | text | Prospects' pain points typically solved by the product. |
| keywords | text | Keywords which Koneksi should look for online to find relevant information about the target prospect's company and their needs. |
Description of each Prospect element in the request body, nested within the User.
| Element | Field type | Description |
|---|---|---|
| first_name | string | Prospect's first name. |
| last_name | string | Prospect's last name. |
| company | string | Prospect's company name. |
| customer_website_url | string | Prospect's company website URL (if available - this isn't mandatory). |
| string | Prospect's LinkedIn profile URL. | |
| api_message_type | array of strings | Types of messages that should be generated for this prospect. Options are: connect, first follow-up, share-material. |
Description of each Prospect element in the request body, nested within the User.
| Element | Field type | Description |
|---|---|---|
| first_name | string | Prospect's first name. |
| last_name | string | Prospect's last name. |
| company | string | Prospect's company name. |
| string | Prospect's Linkedin profile URL. | |
| customer_website_url | string | Prospect's company website URL (if available - this isn't mandatory). |
Description of each api_message_type option available for each prospect. Each prospect can have one or more of these message types in their api_message_type array:
| String option within Array | Description |
|---|---|
| connect | A message under 300 characters that will be included within a connection request. |
| first follow-up | NOTE THAT FOLLOW-UP IS HYPHENATED. A first message which is sent if a prospect accepts the connection request. |
| share-material | NOTE THAT THIS IS HYPHENATED. A message which picks an relevant aspect of a blog, whitepaper or case study and explains to the prospect why they, in particular, might find it helpful or interesting. |
| event invitation | (coming soon!) |
Mandatory Fields
The following fields are mandatory in every request:
- user.full_name (unless already provided)
- user.email
- user.company_name (unless already provided)
- user.customer_company_website (unless already provided)
- user.short_company_description (unless already provided)
- user.benefits_of_product (unless already provided)
- user.ideal_customer_profile (unless already provided)
- user.list_of_pains (unless already provided)
- user.keywords (unless already provided)
- user.prospects_attributes
- prospects_attributes.first_name
- prospects_attributes.last_name
- prospects_attributes.company
- prospects_attributes.linkedin
- prospects_attributes.api_message_type (must be an array of strings)
Responses
Koneksi will send a response that contains a code, a description, and if no errors, a secure_request_id. You will need to use that secure_request_id to retrieve the messages via the Retrieve Messages API.
| Code | Description |
|---|---|
| 200 | The user and prospects were transmitted succesfully. Koneksi will now create or update prospects based on the provided LinkedIn URL and will initiate message generation for each message type specified. |
| 401 | Unathorized request - either because the API key is incorrect, or because the account is out of credits. |
| 422 | Unprocessable entity. The information transmitted in the request is not formatted correctly, or is missing required information. |
| 500 | Internal server error. |
We've got you covered
Frequently Asked Questions
We hope this helps, but feel free to reach out to us via Contact Us if there's anything we haven't answered.
Our generated messages yield a response rate up to 30x higher than basic dynamic keyword personalization alternatives, all while costing less than 3x the price. This translates to more than double the ROI (7/3), allowing you to either invest half the funds for the same number of leads or invest the same amount and receive twice the leads.
Highly tailored messages are crucial for engagement. Messages with only light personalization like dynamic keywords fail to drive engagement because the remaining content lacks specificity and relevance. We all ignore generic messages addressed to our first name every single day.
But properly tailoring messages in a way that customizes every sentence for each individual is an incredibly challenging thing to do with automation. This is precisely why we've made it our central focus, incorporating tested experience and rigorous expertise into our messaging engine.
What's more, as the world becomes more adept at identifying automatically generated language, it's increasingly vital to stay ahead of the curve. Only messages that feel the most 'human' will be able to break through readers' skepticism. That's why we remain committed to consistently testing and enhancing our messaging engine, dedicating our efforts so that we continue to be the most human-like messaging tool there is.
We offer a 7 day free trial as standard - and during that period, you can generate messages at any time. You can also cancel at any time and incur no charges.
The intention of this free trial is to give you the opportunity to generate messages, test different configuration options, and, if you want to, send the messages to your prospects. It means you can try the product for free, see the kinds of messages it generates and monitor their success rates, whilst still maintaining control over what you send to who.
There is a hard limit set on the total number of messages you can generate within the 7 day trial period. Please see the pricing page for details. If you want to increase that limit, you can contact us to move to a paid subscription at any time.
In order to send Koneksi messages, you can also run a trial with one of the Send Automation tools in parallel e.g. Skylead or Expandi.
We're glad you asked that, because we've done a lot of work to list all available tools to help you with your research!
We created this summary of all LinkedIn automation tools to help guide you on things like 1) whether they can send Koneksi's messages, 2) price, 3) whether they offer a free trial, and more.
For more detailed information, please head over to see the individual LinkedIn Automation product pages here.
Short answer: it depends on which automation product you are using. Ultimately our mission is to ensure that every LinkedIn automation product in the world is able to use our generated messages. But we cannot guarantee that yet - we're working on it.
If you use Skylead, we can guarantee that Koneksi's tailored messages can be loaded into your campaign and sent automatically, with just one click.
If you are using another LinkedIn automation product, it will likely be possible to load Koneksi's messages via csv. Tools like Expandi, Dripify, Salesflow, Waalaxy and more support this process already.
If you are using a LinkedIn automation product that does not have csv upload capability for custom messages, we will speak to the team behind the tool and work with them to find a way to load your messages into your campaign.
The list of LinkedIn automation products we have an agreed process and partnership with will continue to grow.
Our philosophy is that a customer should spend their money only when they really want to.
That's why we offer a free trial for new customers - so that new customers can explore the functionality without spend commitment.
Once customers have made the decision to go ahead and buy our product, we consider it a decision they have made with appropriate information.
Therefore we do not offer any refunds.
This is our secret sauce! Our research mechanism is the core of our business. We are constantly working on ensuring that it is the best in the market and we take pride in maintaining that position.
We only use legally available information. Our messages will never come across as unsettling or invasive, either - your prospects will be glad that you seemed to do your research properly, and will assume you read the relevant information from appropriate publicly available sources.
In order to generate your tailored messages, Koneksi only needs full name and company.
Koneksi has some very clever proprietary functionality to find everything it needs to know about the prospect using only that basic information.
In order to help LinkedIn automation tools send the right message to the right prospect, it helps if you can also provide a Linkedin profile URL for each prospect.
We use it only during the message generation process, to conduct research and generate messages.
Once you delete your prospect information from your account, it is deleted forever from our servers.
Yes! We have an API endpoint that enables you to retrieve messages once they are generated. If you would like to access this, you need to sign up for the API product on our Pricing page.
As an API User, you will also automatically have access to the message-generation-request endpoint - to load your prospects into Koneksi and request your preferred types of messages to be generated for each prospect.
Yes! We have an API endpoint that enables you to load prospects into Koneksi and request messages to be generated. If you would like to access this, you need to sign up for the API product on our Pricing page.
As an API User, you will also automatically have access to the retrieval endpoint - to retrieve all personalised messages once they have been generated by Koneksi.
There are several different ways you can pull together your own prospects list. If you have a LinkedIn Sales Navigator subscription, that is a great place to start.
Alternatively, you could pay an offshore service to pull a list together for you, if you specify your criteria. Or you can create lists using subscriptions to other tools like Apollo, or Crunchbase.
If you'd prefer for us to handle this part of the process for you, we're happy to do it for you - as part of our Done For You product
We have been running automated campaigns from LinkedIn profiles for a number of years without any issue, because we take the necessary precautions.
LinkedIn puts in place a number of restrictions to prohibit the use of bots on their platform. We adhere to strict thresholds to ensure we stay within LinkedIn's bot-detection limits - to protect profiles from being restricted.
So long as the activity being automated from your profile is within the appropriate limits, your profile is safe from restriction.
We have a free ROI Calculator tool that you can use to explore the mechanics of LinkedIn Outreach for your specific business.
The ROI Calculator has a number of preset defaults for information like engagement rates, conversion rate, cost - but is also fully configurable should you have that specific information to hand for your business.
If we are running your campaign for you, then the following will apply:
Once your campaign is running, you will receive acceptances to connection requests and responses to messages on your LinkedIn account as if you had sent them manually.
In addition, we will send you a full summary of your campaign results once it has concluded - including data on acceptance rates and response rates.
We will also send you a list of all recipients that replied to your campaign, to ensure you can double check that you have responded to their replies.
We delete all of your prospect information once a campaign has run.
We use all anonmymous engagement rate data to analyse what we can improve next time.
There are a number of LinkedIn campaign execution tools available via subscription which are able to consume Koneksi's messages and send those to your prospects. If you have an subscription to one of these tools, you are able to set up your own campaigns and configure them to your preferences (including loading them with Koneksi messages).
We maintain a list of LinkedIn campaign execution tools on this blog post here, with an indication of whether they can send Koneksi messages or not.
We have an existing integration with Skylead, which means that if you choose to use Skylead as your campaign automation tool, you are able to load your prospects and messages into Skylead from Koneksi in just one click.