Wow, I can't believe that this turned out to be a hard question. I guess the answer is that there is no simple reference of the fields that you send to create a contact? I can't describe my rage at this. I mean, what's the freaking point of having an API if you're not going to cover something as basic as this?
I have, however, found a published example of a JSON string that pushes a contact:
$post_body='{"contact":{"fields":[{"type":"name","value":{"givenName":"John","middleName":"","familyName":"Doe","prefix":"","suffix":"","givenNameSound":"","familyNameSound":""}},{"type":"email","value":"johndoe@example.com"}]}}';
This is from
https://github.com/joechung/oauth_yahoo. This example is incomplete (missing street address info, for example), but it's the best thing I've found. Wish I knew what an XML version of this might look like.
Grr.
Aaron.