我如何通过 API 在 Marketo 中的列表中添加潜在客户（电子邮件、姓名）

Question

Marketo API 对于像我这样的新用户来说太令人困惑了。我有电子邮件和姓名，很乐意将其传递给 marketo。我该怎么做？

Answer 1

要通过 REST API 将潜在客户记录推送到 Marketo，有几个端点可供您选择：

Sync Leads 在 POST /rest/v1/leads.json
Push Lead 在 POST /rest/v1/leads/push.json
Import Leads 在 POST /bulk/v1/leads.json

在这三个中，Sync Leads 可能是最容易使用的，因为它需要的附加参数最少。
基本上，您必须向
发出 POST 请求 https://<MUNCHKIN_ID>.mktorest.com/rest/v1/leads.json?access_token=<ACCESS_TOKEN> url 在请求正文中发送您的数据。

您将在实例中的 Admin > Integration > Munchkin 选项卡下找到 MUNCHKIN_ID。仍在管理区域时，您还应该创建一个 API 用户（或允许 API 访问您自己的用户），为 REST API 和该用户设置 LaunchPoint 服务最后请求一个临时的，有效期为 1 小时的访问令牌来测试连接。 REST API 文档的 Authentication 章节详细描述了整个过程。

获得仍然有效的访问令牌后，您可以使用以下数据结构中提供的潜在客户信息进行上述调用：

{  
   "action":"createOrUpdate",
   "lookupField":"email",
   "input":[  
        {  
            "email":"collizo@4sky.com",
            "firstName":"Collizo4sky"
        },
        // …more leads (up to 300) if needed
    ]
}

如果您使用 php，这里有一个示例代码：

$munchkinId = '123-ABC-456';
$accessToken = 'abcdefgh-1234-5678-abcd-12345678abcd:lon';

$url = "https://{$munchkinId}.mktorest.com/rest/v1/leads.json?access_token={$accessToken}";
$dataJSON = [
    'action'      => 'createOrUpdate',
    'lookupField' => 'email',
    'input'       => [  
        [
            'email'     => 'collizo@4sky.com',
            'firstName' => 'Collizo4sky',
        ],
    ],
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($dataJSON));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response  = curl_exec($ch);
curl_close($ch);

var_dump($response);

/**
 * Which should result in a response like this:
 * / 
{
    "requestId":"4033#16612d185ad",
    "result":[
        {
            "id":1042016,
            "status":"created"
        }
    ],
    "success":true
}
/**/

我如何通过 API 在 Marketo 中的列表中添加潜在客户（电子邮件、姓名）

How do i add a lead (email, name) against a list in Marketo via API

marketo