如何通过API针对Marketo中的列表添加销售线索(电子邮件,姓名)

时间:2018-09-05 15:39:38

标签: marketo

Marketo API对于像我这样的新用户来说非常混乱。我有一封电子邮件和姓名,很想将其传递给marketo。我该怎么办?

1 个答案:

答案 0 :(得分:0)

要通过REST API将潜在客户记录推送到Marketo,您可以选择以下两个端点:

在这三者中,“同步线索”可能是最易于使用的,因为这需要最少的附加参数。
基本上,您必须向
发出POST请求 https://<MUNCHKIN_ID>.mktorest.com/rest/v1/leads.json?access_token=<ACCESS_TOKEN>的网址以及在请求正文中发送的数据。

您将在实例的管理>集成> 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
}
/**/