I've been trying to specify and external id for my surveys. Sometimes if a really obvious one is chosen (e.g. 4) I get told that this has already been taken. When I pick a non-obvious one there is no error but the external_id fails to be reflected in the survey.

I don't know if this is a big or there's just some criterion that I'm missing for what constitutes a valid external_id.

Currently, custom fields return a name and value. In the case of the Checkbox field type, there is no way to tell this apart from a Text field type. Where the custom fields for each nation is unknown, it is impossible to tell them apart and you end up with a situation where checkbox custom fields have to display a value of 1 or 0.

I think a new method is needed to list a nations custom fields and their types. For instance by only being able to view a custom field on a person I am unable to tell the difference between a text and a multiple choice field.

Also I am unable to infer the possible options for a multiple choice field if there is no person with that option. 

This is needed to ensure proper cotnact synchronization between an external database and NationBuilder. You can delete from NB, but no webhook fires when data is removed or merged.

How can I delete an address through the API? I have tried using the people/:id endpoint but if I pass an object with something like "home_address": null it doesn't do anything. If I pass an address object with all the components set to null (ie { "address1": null, "address2":null, etc. }) I can see from the main GUI that the components have indeed been blanked but there is still a "delete address" button, which suggests that the address still exists on the system albeit with blank components.

• last_call_id - the time and date of the last call to this person

Is that correct description? Looking at other field it should be 'last_call_at'. 

I would like to design my nation in Webflow because that's what I already know how to use. Im not a developer; Im a marketer. How could I import this design into NationBuilder? Looking into the documentation a bit, I think i'll have to export the Webflow theme in Bootstrap format if possible? Then go and manually import each of the bootstrap files into the right places in the NationBuilder DropBox Bootstrap layout? Would anyone want to do this for me for a fee?

Hello, I found a small mistake in the API documentation. On https://nationbuilder.com/people_api under the Push Endpoint, it says " If a match is not found, a new person is created and a 201 status code is returned", which is correct: https://cl.ly/rUFV But further down the page under "Creation example" it says "A new record will be created with the provided attributes and you will receive a response of status 200" (note the 200 instead of 201): https://cl.ly/rV8G Minor issue, but wanted to let you know! Thanks!

In some tests I noticed that responses from /oauth/token have the attribute "expires_in". This attribute isn't included in the quick start guide example response, and a colleague found an article about access_tokens no longer expiring. Anyone have more information about this topic?

Many supporters have work addresses -- this is where the employer's address is stored when people give that info when making donations. 

However, it appears that the webhooks API only pushes out a supporters' primary address? This is not explicitly confirmed in the docs but I've done some testing and think this is the case. 

What's more confusing is whether or not this field is available via the REST api. The docs list every other address field. I'm wondering if this is a documentation omission, or if for some reason the work address isn't included? 

http://nationbuilder.com/donations_api The Donations API description of the is_private field reads "false if the donation should not be posted publicly on the site". Is this correct? If is_private == false, then the donation is private; and if is_private == true, then the donation isn't private?

For my organization's use case, we need a synchronization of all donation records, in order to produce financial reports, and for other uses.  This requires high reliability of the synchronization process.

1. Webhooks provide a synchronization potential with the downside that, like webhooks of other internet-based services, there is almost no feedback about webhook invocation failures.  This makes not meet the requirements of our use case.
2. Querying the table of donation records as a replacement, or a verification procedure, of the webhook method would be workable.  However, since donations do not currently provide a search endpoint with an "updated_since" parameter, this creates the problem of having to download the whole donation table each time a synchronization is required.  This limitation makes the method virtually unusable for production employment in our use case.

Could you lift any of these limitations, or is there another way to solve this problem.  Again, we have the legal necessity of not missing any records, or misrepresenting any record fields.

Thanks,

--

Pav

It seems that the data that we get when we pull through the API is different than the data that you get when you just download a CSV file from a nation. The result is that the lists we pull from your API had about 20% duplicates. 

Any thoughts on an email API that could help supporters recruit others? For example, I want to start a recruiting drive where each supporter recruits at least two others. I'd like to create an app that allows people to enter a few emails, use default/editable text, and send emails out right from the page on their behalf. 

The headers in responses from the API specify "Content-type: application/json", but don't specify an encoding. As other aspects of the system use utf-8, I'm assuming that it should be "Content-type: application/json; charset=utf-8".  Am I right? If so it would be helpful if this could be fixed or documented.

The export csv contains address fields such as “primary_country” and “registered_country”, which contains the name of the country. The API People-endpoint does not contain those fields. The API does contain the “country_code” key. Is there another endpoint that allows me to read/write to the country name fields e.g. “primary_country” and “registered_country”?

I followed the PHP API Quickstart guide http://nationbuilder.com/php_quickstart and was able to easily obtain an access token. However, when I am trying to use the API in any way I get the following error response:

Array ( [result] => Array ( [error] => nation_not_found [message] => The nation identified by this request was not found. ) [code] => 404 [content_type] => application/json )

My nation is safestreets.nationbuilder.com, is there a setting I have to enable in order to use the API? Thanks.

I'm attempting to check the tags that will be added to users when they RSVP, but that attribute does not appear to be returned by the events API. We get the page tags, but not the RSVP tags. Seems like those are saved here — [signup_action_callbacks_attributes][0][tag_list] When setting up any number of events, it's very easy to miss a setting, and this is a major point of pain for my nation — if an event goes by and the RSVP tags are missing, we've got a whole set of people mis-tagged. I'm just trying to build a tool that would flag those events so we can fix them — so I'd only need read access to this attribute. Wondering if there's any way I can get access to this attribute on events?

Posted this on the Events API page (http://nationbuilder.com/events_api) but thought I should post here as well:

For the guests_count parameter, what is the API referencing? When you create an event, you have the option to do a simple RSVP and include +1s. However, if you have ticket sales, you purchase a number of tickets. Does guest_count reference +1s or number or tickets, or both? Ideally, it would great if it’s both!

Ive tested this in the API explorer as well as with the following command line invocation:

curl -X GET --header "Content-Type: application/json" --header "Accept: application/json" https://agv.nationbuilder.com/api/v1/sites/agv/pages/events/\?id\=...\&access_token=...

Both produce contact phone numbers with the first number missing

e.g. 0411222333 is given as 411222333

Viewing the event via http://victoria.greens.org.au/ocean_grove_doorknock_and_snack 

we see that the correct, full phone number is displayed.

Can you please fix this?

http://cdale77.github.io/blog/2013/11/13/nationbuilder-webhooks/

This could be a really powerful tool for our canvassers. But.... when I tried to build off it, I ran into a couple roadblocks.

1. A 1mi search radius is far too big for someone walking around door-to-door
2. There wasn't any way to limit the search to only people with complete addresses on file

There is an Exports API for a specific list. (POST /api/v1/lists/:list_id/exports). Is there an API to export all people from a nation?

I can't seem to get the Exports Create/Run endpoint working through either the API explorer or actual calls from code. I am adding the following json to the request body:

{
    "export": {
        "context": "people"
    }
}

and adding the list_id to the query string but all I get in response is HTTP 406 (Not acceptable). Am I doing something wrong?

Additionally, the API explorer doesn't allow you to provide a value of the list_id parameter for this endpoint.

The "updated_at" field is not included in exports initiated via the Export List endpoint;  "created_at" is included. Could "updated_at" be added please?

We have tried to integrate our donation management system with NationBuilder and have had some limitations in your api preventing this. It would be nice to have NationBuilder expose via API:

1. A way for an unfulfilled pledge (i.e. non paid pledge) to be created into a nation
2. Get a list of unpaid pledges
3. submit payment for a pledge and mark the pledge as fulfilled

This would allow us support NationBuilder as a possible persistence backend in our application

http://nationbuilder.com/suggest?utm_campaign=public_issues&utm_medium=email&utm_source=3dna

For cron jobs or similar we need Nationbuilder to extend it's Oauth2 model to include Resource owner credentials grant

Right now, the only way to find out how many people are tagged with a specific tag in your nation, via the API, is to call the people method, which returns a paginated list of people with that tag. You then have to go through every page, incrementing the counter for every person. Needless to say this involves a fair few API calls for large tags.

There's already a tag index where you can see a list of tags - we just need that index to include a number too.

It would be great to see the ability via the API to get any existing relationships a person has and add new ones, as you can do via the GUI.

I've been using the new 123contactform integration and it is fantastic!  But...it seems to be missing some standard fields that are available in the people/edit page on NB. 

From 123contactform you can map to home, meetup (what is this? it doesn't seem to exist on the NB side), billing, and mailing addresses, but there is no work address available.

Also, the primary address is there, but according to other posts I've seen, the primary designation is set to whatever address gets populated first.  When mapping from 123contactform to NB on the primary address fields, it doesn't populate because of that.

There is also no work phone available. 

Can you make work phone, work address, and website available in the integration?

If you're building PHP apps on our API, this should come in handy. Please note that this is third-party code and is not supported by NationBuilder. PHP developers have also indicated that Lusitanian's library is helpful. For official resources, browse our docs.

With the current People API you can add a note to a person's profile which is great! However, it would be fantastic if you could also get those notes too via the API.

Is it possible to get the custom name and abbreviation that someone has assigned to the (political/social) capital feature?

For example, if someone has changed "Political Capital" to "My Community Points" ("MCP"), we want to use that as the label when displaying capital_amount_in_cents. Displaying "Political Capital" generically could confuse people in many cases.

[

I think there is a problem with the quickstart for PHP.

Someone with access to the Nation's resources will have to visit that url in a browser, accept the application and retrieve the authorization code from the page url. That page url will look something like:

GET http://yourapp.example.com/oauth_callback?code=123456abcdef

Use the code to generate an access token:

But it doesn't make sense, this a program, not a person accessing a browser and getting the code. How can I get the code 

using PHP, not someone visiting the url in a browser?

Anthony

I am having an issue with a simple app script to create a person record in NationBuilder. I've checked my JSON data and verified it with REQBIN and it works in the API explorer. The error is "I can only talk JSON. Please set 'Accept' and 'Content-Type' to 'application/json'" I have both of the attributes in the options model. I've even tried every possible capitalization combination.??? If anyone has some google app script that is known to work, I would really appreciate it. Everything I have found so far isn't working. TIA.

I am working with a group that has a WordPress  website with the Formidable plug-in. They want to create forms in WordPress and have the information passed to Nationbuilder in real time. Does anyone have knowledge or experience in setting up the Formidable API to connect with the Nationbuilder API?

Hi

Can you please advise what the reference of EndPointProvider and ServiceRequest<PersonContainer>, it shows error (both object are not existing) when I build the PesonSerivce.cs file.

publicPerson CreatePerson(Person person)

{

string endpoint = EndPointProvider.GetCreatePersonEndPoint();

var container = newPersonContainer(person);

var request = new ServiceRequest<PersonContainer>(endpoint, container);

PersonContainer result = PostWithResult<PersonContainer, PersonContainer>(request);

return result.Person;

}

And same issue happens on the Service.cs,  Task<HttpResponseMessage>,

ConfigProvider and MediaTypeWithQualityHeaderValue("application/json") cannot be found.

Such as code below

privatevoid SendRequest<T>(ServiceRequest<T> request, Func<HttpClient, Task<HttpResponseMessage>> sendFunc)

whereT : class

{

using (var client = newHttpClient())

{

client.Timeout = ConfigProvider.ServiceTimeout;

client.DefaultRequestHeaders.Accept.Clear();

client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

Task<HttpResponseMessage> postTask = sendFunc(client);

Task.WaitAll(postTask);

HttpResponseMessage response = postTask.Result;

if (response.IsSuccessStatusCode)

{

return;

}

Task<string> responseTask = response.Content.ReadAsStringAsync();

Task.WaitAll(responseTask);

string responseText = responseTask.Result;

string payloadString = request.Payload != null ? JsonConvert.SerializeObject(request.Payload) : null;

Logger.Error("Error sending {0} to: {1}. Response: {2}", payloadString, request.Endpoint, responseText);

thrownewInvalidOperationException("API call failed.");

}

}

regards

Stanley

I am building an app integration. I've implemented the OAuth flow described at https://nationbuilder.com/api_quickstart. Suppose that two nations, N1 and N2, both install my app. As a result of following the OAuth flow, my app has now obtained API tokens for both nations, so it can make API requests on behalf of either one. I want to limit who can prompt my app to act on behalf of a given nation. For example only someone affiliated with N1should be able to prompt my app to access N1's data via the NB API. Conversely someone affiliated with N1 should not be able to prompt my app to access N2's data. In order to limit access appropriately, my app needs a way to know which nation is asking it to do something. How can nations identify themselves to my app in a secure way?

There doesn't seem to be a way to either create pages as sub pages through the api or to attach existing pages to other pages as sub-pages.

Any help would be appreciated.

Thanks,

Steve

I have already used PUT people/:id/taggings api for that. But it is giving me response Bad Request Your browser sent a request that this server could not understand. [code] => 411 [content_type] => text/html )

Hi,

I've got a simple PHP app running on our site but I want to know who is using it and ensure obviously only the right people can use it.

Can someone point me to the docs on doing just that please?

Mat

Hi all,

is it possible to check if the user has control panel access via the API? Perhaps also with their access level? Maybe using the /api/v1/people/me endpoint? Thanks!

How to get client id and api secret

Hi all, do you know how can I use the API to get the same list of people that appear under "Contacted By" on the data entry sheet?

I'm working on a data entry app and would like to have similar functionality to be able to choose who contacted a person. Thanks!

Hi, It is possible to get the primary address, but I can not find a way to get the registered address. What can I do? Thanks

I've tried saving the access token as a key/value pair in the $_SESSION variable, but if

a) I encrypt it and then save it, on the next page or request, it has changed or 

b) I don't encrypt it and save it as a string, it is deleted from $_SESSION on the next page.

What am I doing wrong here? I need to make multiple requests in sequence and have a feeling I shouldn't need to ask for a new access token with each one. Thanks!

We are trying to set this field on update. We set id to an existing person is, however do not see this was reflected on the updated person page.

"last_contacted_by ": { "id": "XXX"  } 

Also, 

I'm trying to import a few Wordpress sites using the API.  On each of them every blog post has a header image.  The equivalent in NationBuilder would be to add a signle featured content slider to each page, but I don't see anything in the API to do this.  Am I missing something?  If this can't be done, is there a way to set HTML before the content_before_flip?